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Preface 


This publication is designed as a tutorial aid for IBM Sys- 
tem/3 Modei 15 system operators; it can also be used as a 
reference manual for spooling support. In general, the pro- 
grammer or analyst does not need to be concerned with 
spooling functions and operations; however, with an under- 
standing of spooling, he or she can alter the application to 
achieve optimal results. 

These topics are described in this publication: 

@ Spooling concepts 

@ Processing with spooling 

@ Processing without spooling 

@ The relationship of spooling to other system facilities 


@ OCC (operator control commands) used with spooling 


@ Spooling implications for OCL (operation control 
language) 


® Spooling performance 


@ Spooling problem situations 


Sixth Edition (September 1979) 


In order to understand the text, the reader must be familiar 
with the operation of the System/3 Model 15 or with a 
System/3 Model 10 Disk System. /BM System/3 Model 15 
Introduction, GC21-5094, describes Model 15 concepts. 
Other related publications are: 


@ /BM System/3 Model 15 Operator’s Guide, GC21-5075 


@ /BM System/3 Model 15 System Control Programming 
Reference Manual, GC21-5077 (for 5704-SC1) 


@ /BM System/3 Model 15 System Control Programming 
Concepts and Reference Manual, GC21-5162 (for 
5704-SC2) 


@ /BM System/3 Model 15 System Generation Reference 
Manual, GC21-7616 


@ /BM System/3 Model 15 System Messages, GC21-5076 


@ /BM System/3 Model 15 3340 Direct Access Storage 
Facility Reference Manual, GC21-5111 


@ /BM System/3 3741 Reference Manual, GC21-5113 


@ /BM System/3 Model 15 Master Index, GC21-5202 


This is a major revision of, and obsoletes, GC21-7632-4 and technical newstletter 
GN21-5633. Changes or additions to the text and illustrations are indicated by a vertical 


line to the left of the change or addition. 


This edition applies to version 07, modification 00 of the 1BM System/3 Mode! 15 
System Control Program 5704-SC1; to version 04, modification 00 of the iBM System/3 
Model 15 System Control Program 5704-SC2; and to all subsequent versions and 
modifications until otherwise indicated in new editions or technical newsletters. 


Changes are periodically made to the information herein; changes will be reported in 


technica] newsletters or in new editions of this publication. 


Use this publication only for the purposes stated in the Preface. 


Publications are not stocked at the address below. Requests for copies of IBM 
publications and for technical information about the system should be made to your 


IBM representative or to the branch office serving your locality. 


This publication could contain technical inaccuracies or typographical errors. Address 
your comments about this publication to 1BM Corporation, Publications, Department 245, 
Rochester, Minnesota 55901. IBM may use and distribute any of the information you 
supply in any way it believes appropriate without incurring any obligation whatever. You 


may, of course, continue to use the information you supply. 


© International Business Machines Corporation 1974, 1975, 1976, 1977, 1978, 1979 
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Spooling is an optional facility of the system control pro- 
grams (Program Numbers 5704-SC1 and 5704-SC2} for 
System/3 Model 15. 


In addition to the minimum system configuration for 
System Control Program 5704-SC1, spool requires 5445 
Disk Storage Model 1, 2, or 3 when using a Systern/3 
Model 15A. For information concerning the minimum 
system configurations for the system control programs 
(5704-SC1 and 5704-SC2), see one of the following 
publications: 


@ /BM System/3 Model 15 System Generation Reference 
Manual, GC21-7616 


@ /BM System/3 Model 15 Introduction, GC21-5094 
Although partition 3 (P3) and 3344 Direct Access Storage 


are discussed throughout this manual, they are supported 
only by System Control Program 5704-SC2. 


A comparison of possible disks tor the spooi file is given 
in Figure 1-1. 









Spool File Disk Types 
3344 Main 


Data Area 





System Control [5704-SC1 


Program Numbet 


5704. 5C2 | 5704-SC2 






D1, D2, D1, D2, 
03, D4 






Possible Unit 
Codes 


03, 04, 
D31, D32, 
D33, D34, 
D41, 042, 
D43, D44 


Maximum Size 166 166 186 


in Cylinders 





Figure 1-1, Comparison of Possible Disks for the Spool File 


With 5704-SC2, the spool file copy program (SQCOPY) can 
be used to copy entries to and from the spool queues. Refer 
to the /BM System/3 Modei 15 System Control Programming 
Concepts and Reference Manual, GC21-5162, for information 
about $QCOPY. 


Chapter 1. Introduction 


When directly attached to the Model 15, the 3741 Data 
Station Model 1 or 2 or 3741 Programmable Work Station 
Model 3 or 4 can be used as the spooled input device. 
When this option is selected, 1- through 128-byte records 
can be read. Spooling will truncate (on the right) or pad 
with blanks (on the right) the 3741 records to fit the user 
program’s requested length. {n this publication, references 
to card input also apply to input from the directly attached 
374i. 


It is possible to spool unit-record devices used in a program 
partition that is performing teleprocessing operations. It 

is not possible to spool readers, punches, or printers attached 
to terminals that are connected to the system using the 
binary synchronous communications adapter, multiple line 
terminal adapter, or local communications adapter. 


The IBM System/3 Model 15 is a two- or three-partition 
multiprogramming system. (SCP 5704-SC1 supports two 
partitions; SCP 5704-SC2 supports three partitions.) 
Spooling, an optional facility of the system control pro- 
gram, can improve the throughput of an application. 
System/3 Model 15 offers a variety of operating environ- 
ments: 


@ One-, two-, or three-batch partitions, each with or 
without spooling 


®@ Combinations of batch and communications, each with 
or without spooling 


Spooling support for the Model 15 facilitates handling 
unit-record input and output at disk I/O speed, thereby 
increasing total system throughput. 


With spooling, a job is stored on disk. When the processing 
unit becomes available, the job is transferred from disk to a 
program partition. As the job executes, its printed and/or 
punched output is stored on disk. Upon operator request, 
the output may be printed and/or punched while other jobs 
are executing; thus, the job executes without having to wait 
for the slow unit-record devices. 
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Whenever a spooled reader, card punch, or printer becomes 
inoperative, the system continues processing jobs already 
on disk. When the |/O unit becomes operative again, 
reading, punching, or printing continues without a loss of 
output or processing time. 


With spooling, programs can be run in different partitions 
without the need for separate unit-record devices for each 
partition. The printer, for example, can be used by multiple 
partitions if it is being serviced by the spooling function. 


Performance of a spooling system varies widely. In some 
cases, such as applications with short programs or with 
small amounts of unit-record |/O, spooling may offer little 
or no advantage. In other cases, such as those in which 
unit-record device contention is a problem, spooling can 
provide substantial benefits in overall application 
throughput. 


LEVELS OF SUPPORT 

A user need not spool all unit-record I/O activity; during 
system generation, one of the following four levels of |/O 
support can be selected: 

@ Print spooling 

@ Print and punch spooling 

® Input and print spooling 


® Input, print, and punch spooling 


The following unit-record devices can be spooled: 
@ 5424 MFCU 

@ 2560 MFCM 

@ 1442 Card Read Punch 


@ Directly attached 3741 Data Station/Programmable Work 
Station (input only) 


@ 2501 Card Reader 


1403 Printer 


The combination of devices that can be used with the 
different levels of spooling support is shown in Figure 1-2. 
The user also chooses the program partitions to be supported 
by spooling: partition 1 only, partition 2 only, partition 3 
only, or any combination of partitions. 


This publication assumes that you have selected input, 
print, and punch spooling. 


LEVEL OF SUPPORT 
































Figure 1-2. Combination of Devices Available for Different Levels of Spooling Support 


CONCEPTS OF SPOOL OPERATION 


To handle a system’s unit-record I/O without depending on 
1/O device speeds, spooling support utilizes disk space on 
5445 Disk Storage or on the main data area of a 3340 Direct 
Access Storage Facility or 3344 Direct Access Storage as 
intermediate storage for areas known as queues (see Figure 
1-3). As job streams (including operation control language 
statements, programs, and data) for the individual parti- 
tions are read, a spooling routine stores each job in the 
reader queue; this routine is called the reader. 


After a job has been completely read and stored in the read- 
er queue, it is ready to be transferred to the appropriate 
partition for execution. All records appear to the partition 


as though they were just read from the physical input device. 


When all job steps in the job have been executed, the spool- 
ing support removes the job from the reader queue. 


Printed and punched output is also stored temporarily on 
disk in queues. Spooling routines called the print writer 
and punch writer enable printing and/or punching of the 
data in the print queue and punch queue upon operator 
request (see Figures 1-4 and 1-5). 


ADVANTAGES OF SPOOLING 


The preceding concepts of spooling operation point out 
these advantages of spool support: 


@ Asynchronous operation 
@ Improved system performance 
@ Reduced device contention 


Asynchronous operation. Reading the input records from 
the spooled reader to disk, printing the spooled print re- 
cords on the printer, and punching the spooled punch 
records on the card punch are functions of spooling that 
occur independently of programs executing in the partitions. 


Improved system performance. The execution time of any 
one job is likely to be decreased because unit-record oper- 
ations are performed at disk I/O speeds. Spooling writes 
blocked input and output records on disk, further increas- 
ing system throughput because the number of disk 1/O 
Operations is less than the equivalent number of unit-record 
operations. 


Reduced device contention. Because more than one parti- 
tion can reference the same device at the same time, one 
Partition does not have to wait for the other partitions to 
free the device. 


USER CONTROL 


Execution of the spooling function is controlled mainly by 
the system operator through OCC (operator control com- 
mands) but also by the system programmer through OCL 
(operation control language}. 


The operator controls system spooling activity by entering, 
through the CRT/keyboard, OCC to monitor, control, and 
communicate with the spooling routines. Through operator 
control, the spooled reader and output writers can start 

and stop independent of program execution. For example, 
the operator can hold job input in the reader queue for 
execution at a later time, allowing jobs that need more 
execution time to be held until the system is less occupied. 
Or, the operator can hold job output in the punch and 

print queues until it is convenient to punch or print it. 


The system programmer can make efficient use of the sys- 
tem in defining the jobs and supplying OCL for each job. 
For example, if one job (D) spools a large volume of print 
and/or punch output, it is advantageous to complete that 
job before executing a series of processing-oriented jobs 
(A, B, C): 


Job Characteristics 

A Processing-oriented 
B Processing-oriented 
Cc Processing-oriented 
D 1/O oriented 


If the output writers are started while the processing- 
oriented jobs are executing, the processing unit and the 
t/O devices can be used simultaneously. 


An example of OCL spooling control is the DEFER-NO 
Parameter on the PRINTER and PUNCH statements. When 
the system programmer includes this statement, the 
operator can start the print or punch writer while the job 
step producing the output is still executing. 


Introduction 1-3 


Job Input 
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Note: User files on disk and magnetic tapes are not handled by the spooling function. 


Figure 1-3. Processing with Spooling 


The JOB statement is read from the spooled reader and 
queued on the disk before the start of a job. Similarly, the 
job output is stored on the disk in punch and/or print 
queues; punching and printing occurs later. 


Note: A single disk contains the reader, print, and punch 
queues. 
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spool input device 
during system 
generation) 






Supervisor 


Spooling 

Routines L 
Partition 1 La 
pee 


Jobs are transferred from the reader queue to one of 
the partitions, as required. 





Reader 
Queue 















Spool File 





Figure 1-4. Spooling Operation 
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Figure 1-5. Spooling Operation 







This chapter covers the following spooling topics: 


®@ Generating a spooling system 


IPL (initial program load) 


Reading (input spooling) 
@ Job execution 
@ Printing 


@ Punching 


GENERATING A SPOOLING SYSTEM 


During system generation, the user chooses the spooling 
support needed according to these considerations: 


Amount of main storage available 
Disk space available 

Job stream characteristics 
Desired throughput 


One of the following four levels of spooling support can 
be selected during system generation: 


Print spooling 

Print and punch spooling 

Input and print spooling 

Input, print, and punch spooling 


Chapter 2. Processing with Spooling 


The level of spool support determines which unit-record 
devices can be spooled. The selected level can apply to 
partition 1, partition 2, partition 3, or any combination of 
partitions. If input spooling is chosen during system genera- 
tion, one of the following input devices must be selected as 
the device from which spooled input will be read: 


MFCU1 (MFCU primary hopper) 
MFCU2 (MFCU secondary hopper) 
1442 

MFCM1 (MFCM primary hopper) 
MFCM2 (MFCM secondary hopper) 
2501 

3741 (directly attached) 


If punch spooling is chosen during system generation, one 
of the following punch devices must be selected as the 
device on which spooled output will be punched: 


MFCU1 (MFCU primary hopper) 
MFCU2 (MFCU secondary hopper) 
1442 

MFCM1 (MFCM primary hopper) 
MFCM2 (MFCM secondary hopper) 


The 1403 printer is always supported whenever spooling is 
specified, and it is the only printer that can be spooled. For 
5704-SC2 only, an additional 1403 printer can be selected 
during system generation and used by a second spool print 
writer. See Chapter 9 for information on the second 
printer. 


Figure 1-2 shows the combinations of unit-record 1/O 


devices that can be used with the different levels of spooling 
support. 


Processing with Spooling 2-1 


In addition to selection of the level of spooling support and 
the spool |/O devices, the following spool information must 
be provided during system generation: 


Spool disk unit 

Spool disk space 

Track group size 

Partitions with spool support 
Forms type and card type 
Autostart option 

Autowrite option 

Extended restart option (5704-SC2 only} 
Time recording option 
System input device 

Main storage size 


Spool Disk Unit 


Only one disk unit (see Figure 1-1) can be specified to 
contain all spooled data; the spool area cannot be extended 
to another disk. The unit assignment can be changed during 
IPL using the START SPOOL command (see Chapter 5). 


Spool Disk Space 


The amount of space (in number of cylinders) allowed for 
spooled records must be specified with a maximum of 199 
cylinders on a 5445 disk, 166 cylinders on a 3340 main 
data area, or 186 cylinders on a 3344 main data area 
indicating full pack capacity. The space is obtained on the 
specified disk unit during IPL and reserved for use by 
spooling under a filename (SSPOOL) in the VTOC. [The 
$SPOOL file is a special type of file that cannot be accessed 
by data management; it is listed when you run the File 

and Volume Label Display Program (SLABEL).] Once the 
spool area is full, space must be freed in order to continue. 
The amount of disk space can be changed during IPL by 
using the START SPOOL command (Chapter 5). The 
following items should be considered when specifying the 
size of the spooling area (Appendix C contains formulas 
for estimating the size of the spool area): 


Level of spooling function 
Mode of operation 

Type of printing and punching 
Volume 


2-2 


Level of Spooling Function: A system with only print 
spooling requires only disk space to contain the print 
records produced, whereas a system with input/print/punch 
spooling support requires disk space to contain the input 
records read and the print and punch records created. 


Mode of Operation: When the spooled output of a job 
step is completely punched or printed, the space in the 
spool area Is available for other output records. Thus, if 
the purpose of spooling is to save output until a later time 
(such as second shift), a larger spool area is required than 
if the records are punched/printed as available. 


Type of Printing and Punching: Output records containing 
few characters require less disk space than records contain- 
ing many characters. This is because spooling support trun- 
cates rightmost blanks when storing output records on disk. 
For example, Job A punches columns 1-20, and Job B 
punches columns 11-20 and 30:70. Each record written 

by spool to disk for Job A contains the 20 characters to be 
punched, while each record for Job B contains 70 characters. 


Volume: Jobs that have few input records or produce only 
a few output records require less disk space than jobs that 
have a large volume ct input data or create a jarge volume 
of output records. 


Track Group Size 


The disk space for the spool file is segmented into equal 
size groups of tracks. Each track group represents an ex- 
tent obtained by spooling each time space is needed. The 
allowed track group sizes are 1, 2, 4, 5, and 10 tracks. The 
smaller sizes minimize unused areas within spooling disk 
space; the larger sizes improve performance for jobs with 
large volumes of output by minimizing the number of 
times spooling is required to obtain additional disk space 
(see Appendix D). 


Partitions with Spool Support 


tf single partition support is desired, the partition (1, 2, or 
3) to be spooled must be specified. When multiple-partition 
spool support is chosen, the support is the same in each 
partition. 


Forms Type and Card Type 


The forms type and card type options supply the default 
forms type and card type that will be used for spooled 
printed and punched output. An alternate forms type or 
card type may be supplied on the PRINTER or PUNCH 
OCL statements at execution time or by using a CHANGE 
command after execution has completed. 


Autostart Option 


The autostart option automatically starts the reader, print 
writer, and/or punch writer when spooling is activated at 
IPL. This option relieves the operator of having to enter 
the START RDR, START PRT, and START PCH com- 
mands at IPL; however, once the reader has been termi- 
nated, aSTART RDR command is required to activate the 
reader again. Likewise, once the writer has been termina- 
ted,a START or RESTART command is required to acti- 
vate it again. Because the punch writer and reader cannot 
be operating simultaneously, both cannot be automatically 
started when input and punch spooling are supported. 


Note: \f the autostart option was selected, the print writer 
or punch writer begins automatically at IPL if there are 
records already in the queues. If there are no records in the 
queues, the output writers are started by the operator 
response to a message that the queues are empty or held. 


Autowrite Option 


The autowrite option reduces the interaction between 
spooling and the operator. When the print writer or punch 
writer starts, it automatically prints or punches whenever 
output is available on the queue, When an output queue 

is held, all steps on the queue are held, or when the queue 
is empty, no message is written to the CRT informing 

the operator of the situation. No operator action is neces- 
sary to cause the writer to begin execution again. The 
writer merely waits until output is available and begins 
automatically. 


A job step specifying that the output may be printed or 
punched during execution causes the writer to begin print- 
ing or punching if there is no output on the queue ahead 
of the executing job step. 


The writers can still be stopped and started by using OCC. 
When stopped, the writer does not automatically begin 
when output is available; the operator must start the 
writer before output can begin. 


Extended Restart Option (5704-SC2 only) 


The extended restart option automatically restarts some 
system messages; two such spool messages are NO INPUT 
JOB AVAILABLE and RDRO!S EMPTY/HELD. 


Whenever a job is placed on the reader queue, al! NO 

INPUT JOB AVAILABLE and RDRO IS EMPTY/HELD 

messages will be restarted if the new job can be run ina 

partition that is halted by one of these messages. The 

messages will not be restarted if: 

— The queue is held, 

— The job is for another partition, 

— The JOB statement has PRIORITY-O specified, or 

— The CORE parameter value specified on the JOB state- 
ment is too large. 


For information on other system messages that can be 
automatically restarted, see the /BM System/3 Model 15 
System Control Programming Concepts and Reference 
Manual, GC21-5162. 


Time Recording Option 


The time recording option causes a message to be written 
in the system history area each time the print or punch 
writer completes a job step. The message contains the 
date and time that the output for the job step was started 
and the time that the output was completed. 


This message may be used as an aid for performance planning 
on a spooling system. For additional information about 
performance, see Chapter 7. The time recording message 
may also be used for job accounting purposes. 


Note: If consistent elapsed times are expected, the output 
writers should have a system priority higher than that of 
the program partitions. For information about the PTY 
command, see Chapter 5. 


System Input Device 


A system input device is assigned to each partition; for ex- 
ample, the 2501 can be assigned for partition 1 and the 
CRT/Keyboard for partition 2. When the operator initiates 
a job for a partition, the partition reads OCL statements 
from its input device. Also, during system generation, if 
input spooling is to be used, an input device must be as- 
signed as the spooled reader. The device assigned as the 
spooled reader can be the same device specified as the 
system input device. 


Processing with Spooling 2-3 


If input spooling for the 2501 were chosen for partition a 


the 2501 should also be specified as the system input device. 


Jobs are initiated from the reader queue when the system 
input device is also the spool input device. 


A partition’s system input device can be changed by a 
READER OCL statement or by a READER command. 
Consider a situation where (1) the system input device for 
partition 1 is the 2501, (2) the spool input reader is the 
MFCM1, and (3) a job to be executed in partition 1 con- 
sists of RPG I! programs that use the MFCM1 for card 
input data. The job is placed in MFCM1, the MFCM is read- 
ied, and the operator issues the START RDR command. 


After the job has been read, the operator should not initi- 
ate job execution in partition 1 until the system input de- 
vice for partition 1 is changed. This can be done with a 
RDR P1,MFCM1 command or by putting // READER 
MFCM 1 in the 2501. Now partition 1 can be started. If 
the operator initiated partition 1 before changing the read- 
er, the system would have attempted to read from the 
2501, which could be empty, contain blank cards, or 
contain some other job. 


Main Storage Size 


The amount of main storage available for spooling should 
be taken into consideration based on the amount required 
to support the desired functions. The main storage require- 
ments for the spooling functions selected are stated in 
Appendix B. 


IPL 


Spooling, selected as a feature during system generation, 
is loaded at IPL with the supervisor. Upon completion of 
the IPL process, the system date can be entered before 
Processing continues. A display on the CRT contains EJ 
messages for the partitions. At this time, before initiating 
any jobs, the operator decides whether to activate or can- 
cel the spool support. The CANCEL SPOOL command 
(see Chapter 5) causes the spooling support to be removed 
from main storage, making additional main storage available 
to any partition. If spooling support is desired later, the 
operator must perform an {PL again. 


If the operator chooses to operate with spool, spooling can 


begin either by a command prior to job execution or by 
operator response to an IPL EJ message for a partition. 
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To start without any changes to the spool disk space, the 
operator begins job execution by replying to one cf the 
IPL EJ messages or entering a START SPOOL command 
(see Chapter 5). Either action causes the disk space used 
by spooling to be obtained according to the disk unit and 
size specified during system generation. Any existing 
spooled input and/or output remains in the spool area and 
is not lost. 


To override specifications made during system generation, 
the operator enters a START SPOOL command with the 
parameters to be changed. The operator may (1) alter the 
spool disk unit used, (2) change the size of the spooling 
area, (3) change the size of the track groups within the 
spooling area, or (4) reformat the spool area (causing exist- 
ing spooled |/O data to be lost). Once spooling is initiated 
{at IPL), the disk pack used for the spooling area should 
not be removed until another IPL is performed. 


Note: \f another IPL is performed while spooling is being 
activated, there is a chance that the spool disk space was 
not completely allocated for spooling. That is, the space 
may have been obtained but an entry was not yet made in 
the VTOC to account for the space. To determine whether 
this situation exists, either attempt to use the disk pack 
again for spooling or display the VTOC using $LABEL. If 
this situation occurs, the FORMAT function of $DELET 
will free the inaccessible space. 


Activating spooling does not cause the reader, print writer, 
or punch writer to start unless autostart has been generated, 
If the autostart function was specified during system gener- 
ation, those devices so specified are automatically started 
when spooling is activated. If autostart was not generated, 
the operator must enter START commands to initiate the 
desired spooling function. 


Entering the START RDR command causes the spooled 
input device to start reading and placing the jobs in 

the reader queue. Entering the START PRT or START 
PCH commands activates the respective output writer 

so the printing or punching of spooled records from the 
print or punch queue can begin. If job steps have not 
put any records into the print or punch queues, a message 
(PRTQ iS EMPTY/HELD or PCHO IS EMPTY/HELD) 

is shown on the display screen. 


if the operator attempts to start either the reader or the 
punch writer after the other has started, a message appears 
on the CRT indicating READER/WRITER ACTIVE since 
both the reader and the punch writer cannot be operating 
at the same time. As soon as the initiated function ter- 
minates, the operator can start the other function. 


At this point, it may be helpful for the operator to display 
the system status to determine that the system is set-up as 
desired. The DISPLAY command (see Chapter 5) with the 
STATUS operand shows the system status; for example, 
for 5704-SC1: 


SYSTEM STATUS 
PARTL — 24K 
CASHFLOW STEP3 
RDR - MFCML (SPOOL) 
PRT - 1403 (SPOOL) 


DISPLAY (SP,P2,P1) 
PART2 — 24K 
LABOR STEP9 
RDR - 3277 
PRT - 1403 (SPOOL) 
PCH ~ MFCM2 (SPOOL) 
AVATLABLE 01/28/74 10:21:41 
SPOOL STATUS DISPLAY 
— MFCM1L/EMP UNIT-Diy CYL~100 
- 1403/ACT/H TKGP SIZE - 5/398 
— MFCM2/ACT TKGPS AVAIL ~ 330 
ENTER DISPLAY REQUEST MSG NOT RSP 03 


PCH - MFCM2 (SPOOL) 


READING (INPUT SPOOLING) 
Job Stream 


Prior to executing any programs on the Model 15 using 
spooling support, the system programmer should consider 
the organization of the job stream. Although no changes 
in the programs are required; the following should be 
observed: 


®@ Several additional OCL statements can be added. 


@ The order of program execution can be changed for 
better performance and device utilization. 


The input stream consists of two different units of work: 
jobs and job steps. Each job is a group of related job steps 
to be executed in a sequential manner. A job inciudes all 
necessary programs, file definitions, and OCL statements 
needed to accomplish a specific function. When input 
spooling is used, the steps must consist of OCL or OCL 
plus data; you cannot spool only the data. 


Defining a series of related steps as a single job may be re- 
quired either because of the sequence of functions or be- 
cause it may provide specific advantages. For instance, 
multiple steps within a single job are preferable when the 
execution of a later step is directly dependent upon the 
successful completion of an earlier step. If a step termin- 


ates abnormally, the remaining steps in the job are bypassed. 





When using input spooling, it is also advantageous to con- 
sider the placement of jobs within the job stream. A job 
with a small amount of input should be placed on the queue 
before a job with a large amount of input, allowing the first 
job to begin execution while the second one is being read 
into the queue. 


OCL Considerations 


The beginning of a job’s OCL is indicated by the JOB OCL 
statement or the statement after a /. statement. All OCL 
statements and data that follow the JOB statement, up to 
the next JOB or /. statement, are associated with that job. 
Any number of LOAD/RUN and/or CALL/RUN combi- 
nations can be included. Spooling uses the information 
from the JOB statement to build the queues on disk. For 
instance, the PARTITION parameter enables jobs for all 
partitions to be read from one system input device by 
specifying the partition designated for job execution. 


The PUNCH and PRINTER OCL statements are also used 
by spooling support and can be included in the job stream 
(see Chapter 6). 


A /. statement should be used after each job as a delimiter. 
(Although, if a /. statement is not used, the JOB statement 
for the next job acts as ajob delimiter.) When the job being 
put in the reader queue is not separated from the next job 
by a/. statement, spooling generates a /. statement as the 
last statement for the job in the queue. When the system 
history area is displayed or printed, or when the statement 
is logged on the system logging device, this statement may 
contain unpredictable characters following the /.. 


Two consecutive /. statements indicate the end of the entire 
job stream. When using input spooling, these two consecu- 
tive /. statements cause the reader to be terminated, releas- 
ing the input device. 
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Performance Considerations 


To improve performance, the following items should be 
considered when planning a job stream: 


1. When spooling input, make the first job one that 
contains little or no input data. The sooner a job 
is on the reader queue, the sooner a partition can 
be initiated to execute that job. 


2. When spooling input, define the first job with a 
minimum number of job steps — preferably one. A 
Partition cannot be initiated until the entire job is 
on the reader queue. 


3. When executing in multiple Partitions, avoid unneces- 
sary disk contention caused, for example, by running 
two sort programs at the same time. 


4. When not using punch spooling support, carefully 
plan the placement of job steps that require the 
punch device. 


5, Avoid contention between the reader and the punch 
device and also between punch requests to the same 
device from muitiple partitions at the same time. 


Limitations of Input Spooling 


The following limitations apply to any input being spooled 
from the job stream: 


® Output operations (such as stacker selection or combined 
files) cannot be performed on spooled input files. 


@ The following record lengths for each device are used: 

a. From the MFCM, 2501, and 1442, only 80-byte 
records are written in the reader queue. 

b. From the MFCU, only 96-byte records are written 
in the reader queue. 

c. Other card sizes, such as 51-column cards, cannot 
be used. 

d. From the 3741, 1- to 128-byte records are written 
in the reader queue. 


@ The read card image (column binary) operation is not 
supported. 
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Reader Queue 


Once the job stream has been constructed, the records 
have been placed into the reader, and IPL has been 
completed on a system with input spooling, the reader 
queue can be built on disk. If autostart was specified 
for input spooling during system generation, the reader 
starts reading records when spool is activated following 
an IPL. If autostart is not in effect, the operator must 
enter a START RDR command when jobs are to be read 
into the reader queue. 


The reader queue is built on disk as the job stream is read 
(see Figure 2-1). To the spool reader, a JOB statement 
indicates the beginning of a new job; a /. or another JOB 
statement indicates the end of the job. One reader queue 
entry is created for each job read. All steps within a job 
are scheduled for sequential execution in the same Partition, 
Each job is identified on the queue by the jobname. If 
any errors are found on the JOB statement, that job is 
assigned a priority of 5 on the reader queue. In addition, 
if the jobname is missing or invalid, the default name 
JOB is assigned to that job on the reader queue. 


JOBB Reader 


7 
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The spool reader continues reading jobs until (1) two /. 
statements are read consecutively in the job stream, (2) 

a STOP RDR command is entered to terminate the reader, 
or (3) a cancel option to a reader error message is taken. 
An informational message (SPOOL RDR TERMINATED) 
appears on the CRT to indicate that the spool reader has 
been terminated. Once the spool reader has terminated, 

a START RDR command is required to restart when addi- 
tional jobs are to be added to the reader queue. 


If jobs are intended to be placed on the reader queue 
from time to time without terminating the reader (for 
example, not providing two consecutive /. statements), 
the following operational considerations should be 
noted: 


1. For the job to be placed on the reader queue, the 
/. statement must be read. Thus, the /. statement 
in the last job (or only job) to be read should be 
followed by a valid OCL statement. 


2. When using the MFCM2, MFCU, 1442, 3741, or 2501 
only one OCL statement is required. When using the 
MFCM1, two OCL statements are required. 


3. If the next job is not yet available, any OCL state- 
ment that does not affect the job processing can be 
used (for example, a comment (*) statement). 


The following example illustrates this concept: 


//JOB1 JOB 
/. 
//JOB2 JOB This statement must be read before 


JOB1 is put on the reader queue. 


//JOB3 JOB This statement must be read before 
JOB2 is put on the reader queue. 


/ 

“ END OF JOB3 If JOB3 is the last job to be put on 
the reader queue and the reader is 
not to be terminated, an OCL 
statement must be provided here 
to put JOB3 on the reader queue. 
In this example, a comment state- 
ment is used. (if the MFCM1 is 
the input device, a second comment 
statement should be used.) 


If the spool reader is started, it is important to remember 
that the punch writer cannot be initiated until the reader 
is terminated. 


Error Conditions 


lf hardware errors, such as feed checks, occur on the reader 
device, the operator should handle the error as though 

on a nonspooling system. When the situation is corrected, 
input spooling can be resumed. If the problem cannot be 
corrected and the operator cancels the operation, the spool 
reader is terminated and the job currently being read is 

not placed on the input queue. To execute the job, the 
spool reader must be started and the job must be reread 
entirely. 


Operator Control 


Operator control commands are used to manipulate the 
reader queue after it has been created (see Chapter 5). These 
commands are CANCEL, HOLD, RELEASE, CHANGE, and 
KEEP. 


For 5704-SC2, the same commands can be used to manipulate 
multiple jobs by specifying, in place of the jobname, one to 
seven characters followed by two asterisks (**). Spooling 

will then perform the requested function on all jobs on the 
queue whose names begin with the specified characters. For 
example, if the HOLD RDRO,ABC** command were 
entered, all jobs on the reader queue whose names begin with 
ABC would be held. 


CANCEL: The entire reader queue may be canceled using 
CANCEL *RDRQ. This command is valuable when the 
Operator realizes (after executing several job steps) that not 
all remaining jobs in the reader queue will execute correctly. 
All the jobs on the queue can be removed with a single 
command. If it is determined that only a particular job 
needs to be removed, the option RDRQ,jobname can be 
used. When it is necessary to cancel a job step on the 
reader queue, the entire job must be canceled. 


A job currently executing in a partition cannot be canceled 
by simply entering CANCEL RDRQ,jobname. It must be 
canceled by specifying the partition; that is, CANCEL P1, 
CANCEL P2, or CANCEL P3. 


HOLD: The HOLD command is used to prevent jobs from 
executing until a more convenient time. Spooling will not 
permit a job step to be selectively held on the reader queue; 
only an entire job can be held. 


For example, if the next job on the queue requires being 
run on first shift and there isn’t sufficient time to run it 
today, the operator may hold it for first shift tomorrow by 
specifying HOLD RDRO,jobname. The HOLD command 
does not affect the priority of the job. If there is a need 

to hold the entire queue, the overator specifies HOLD 
RDRQ. This prevents all jobs on the reader queue from 
being scheduled for execution until the queue is released 
(using the RELEASE command). 


RELEASE: The RELEASE command allows the operator 
to release: 


e The reader queue 


e A job on the queue that was placed in the hold state 
by a HOLD command or assigned a PRIORITY-O on 
the JOB statement 


If the entire reader queue was held, then the entire queue 
must be released; jobs cannot be selectively released. 


In the previous example, on the second day, the operator 
releases the job for execution by specifying RELEASE 
RDRQ,jobname. The priority of the job is not affected 
when it is released. 


CHANGE. The CHANGE command allows the operator 
to change the priority, partition assignment, or main 
storage requirement of a job on the reader queue. 


The job priority can be increased or decreased, and the 
job in the reader queue is processed after all other jobs 
with the same priority have been processed. For example, 
the command CHANGE PTY,5,RDRQO,JOBA changes the 
current priority of JOBA to a priority of 5, and JOBA is 
scheduled for execution after all preceding priority 5 jobs 
on the reader queue have been executed. If the priority 
of a job is changed on the reader queue, the steps on the 
output queue(s) have the new priority, unless they contain 


aPRIORITY parameter ona PRINTER or PUNCH statement. 


The partition assignment for the job on the reader queue 
can be changed. For example, the command CHANGE 
PTN,2,RQ,DAILY changes the partition in which the job 
DAILY is to be executed to P2. 


The main storage requirements of a job can be changed by 
specifying a number between the limits of 0 and 238 for 
5704-SC1 or O and 488 for 5704-SC2 in the CHANGE core 
command. For example, the command CHANGE CORE, 
48,RDRO,DAILY changes the main storage requirement 
for the job DAILY to 48K. The command CHANGE 
CORE,0,RDRQ,DAILY removes any main storage require- 
ment for the job DAILY and allows it to execute in any 
main storage size. 


KEEP: The KEEP command is used to prevent a job from 
leaving the reader queue after all steps of the job have 
executed. Rather, the job remains on the queue in the hold 
state. 


Displaying the Reader Queue 


The DISPLAY RDRO command can be very useful for 
the operator to monitor the reader queue (see Chapter 5). 


The following is an example of how a display of the reader 
queue might appear. The information displayed for the 
reader queue is jobname, stepname, position on queue (POS), 
priority (PR), required main storage (CORE), and partition 
(PT). Main storage is given only when specified on the JOB 
OCL statement or through the CHANGE command. For 
5704-SC2, jobs placed on the reader queue by $OCOPY 
under CCP will have the terminal name displayed in the 
stepname position. 


F10 RDR QUEUE (H) POS PR CORE 
---PRIORITY LIMIT 3--- 
DAILY 1 AB LK 
CASHFLOW TERMOL 2KA3 
LABOR 3 H3  L6K 
SHIPPING 4 Q3 24K 
END OF QUEUE 


ENTER DISPLAY REQUEST MSG NOT RSP O1 





An (H) on the first line of the display indicates that the entire 
reader queue is held via the HOLD command. 


For 5704-SC2, if the priority limit for jobs placed on the 
reader queue by $QCOPY under CCP is less than five, the 
limit is displayed on the second line of the display. 


One or two of the following characters can precede the 
priority number in the display: 


A — Indicates that the job is currently executing in the 
partition shown in the PT column (5704-SC2 only) 

H — Indicates that the job is being held via the HOLD 
command 

«K — Indicates that the job is in a keep state via the KEEP 
command (5704-SC2 only) 

Q — Indicates that the job is being copied by $QCOPY 
(5704-SC2 only) 


For 5704-SC2, an N following the partition number indicates 
that OQCOPY-NO was specified on the JOB OCL statement. 
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EXECUTING JOBS 


After at least one job is placed in the reader queue, the 
operator can initiate job execution by responding to the 
end of job message displayed on the CRT for the partition. 
Spooled input records are read from the reader queue (on 
disk) and passed to the requesting partition; to the Pparti- 
tion, it appears as though the records had been read from 
the card reader. All steps within a job are scheduled for 
sequential execution in that partition (see Figure 2-2). 


Even though job execution has been started, the spooled 
reader does not stop. Execution within the program parti- 
tion does not affect the spool reader, which continues to 
place jobs on the reader queue until (1) the operator enters 
a STOP RDR command, (2) the end of the job stream is 
reached, or (3) the operator selects a cancel option for a 
halt that is issued because of a reader device error. Ifa 

job is not in the keep state, it is removed from the reader 
queue when all steps of the job have been executed, or when 
the job is canceled before completion. 


As job steps execute in the partitions, punched output is 
placed in the punch queue, and printed output is placed 
in the print queue (see Figure 2-3). The print and punch 
records are blocked (with trailing blanks removed) and 
written on their respective queues. Instructions for print- 
ing and punching the records (for example, forms length, 
spacing, card type) are also stored. 
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Identification on the Queue 


The records are identified on the queue by jobname and 
stepname. If a stepnarne was not given, the records are 
identified by the program mame as given on the LOAD 
statement, plus two appended digits that denote the 
step’s position within the job. For example, JOBX with 
programs PRO1, PRO2, and PRO3 is identified as follows: 


JOBX PRO101 
JOBX PRO202 
JOBX PRO303 


The records are identified by jobname and stepname, which 
allow the operator to control a job’s output on a step basis. 


For 5704-SC2, when the records on the queue are produced 
by a program running under CCP, the terminal name is 
generally used as the jobname and a stepname is generated 
by using the program name and a sequence number. The 
sequence numbers start at 21 and are increased by 1 for 
each job step placed on the queue. After 99, the sequence 
number is reset to 00. Separate number sequences are used 
for the print and punch queues. 


For more information about tne jobname and stepname 
used on the spooi queues for CCP, see the /BM System/3 
Model 15 Communications Control Program System 
Reference Manual, GC21-7620. 
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Figure 2-2. Initiating Jobs in the Partitions 
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Figure 2-3. Building the Print Queue and Punch Queue 


Device Contention 


When a system has spooling in only one partition, some 
device contention may occur. Consider the following 
example: 


Partition 1 Partition 2 
Jobname JOBA JOBB 
Input device MFCM1 (spooled) 2501 (not spooled) 
Punch device MFCM2 (spooled) MFCM2 (not spooled) 
Printer 1403 (spooled) 1403 (not spooled) 


JOBA uses ail three partition 1 devices, and JOBB uses all 
three partition 2 devices. 
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'f JOBB needs to punch cards on the MFCM2 while input 
is still being spooled for JOBA on the MFCM1, contention 
occurs, and partition 2 issues the message MFCM NOT 
AVAILABLE. JOBB cannot use MFCM2 until the spooled 
reader has been terminated. At that time, the operator can 
respond to the partition 2 message initiating punching for 
JOBB. 


If JOBA input is spooled to disk before JOBB requests the 
services of MFCM2, the above contention problem does 
not occur. 


A similar contention problem can occur if the print or 
punch writer is started for partition 1 and JOBB needs to 
punch cards or use the printer. If one of these output 
writers has control, it must be terminated before JOBB 
can use the device. If JOBB has control, the output writer 
cannot be started until partition 2 has reached the end 

of job step. 


With the preceding system setup, it is recommended that 
Partition 1 be used for jobs that are mostly limited by 
unit-record 1/O operations (reading cards, printing, and 
punching) and partition 2 be used for jobs that are limited 
by I/O operations other than unit-record (utilities, sorts, 
disk and tape activity). If both partitions had spool sup- 
port in the preceding example, contention may not have 
occurred. 


Considerations 


The following considerations apply to job execution ina 
spooling environment: 


@ An execution-time diagnostic is issued if you attempt to 
spool a combined file. A combined file is a card file in 
which both input and output operations are performed 
(such as reading and punching the same card). 


@ Output operations (such as stacker selection) cannot be 
performed on input files. If your program specifies 
stacker selection, it is not necessary to recompile it. 
Spooling simply ignores the stacker select commands. 
Thus, if program input is not spooled, stacker selection 
occurs; if program input is spooled, stacker selection 
does not occur. If your application requires that input 
cards be separated, then the program can be rewritten 
to punch exceptions, or it can be executed nonspooled. 


@ The read card image operation is not supported. 


Operator Control 


The following OCC commands can be used during job exe- 
cution; they are described because they have spooling im- 
plications. These commands are CANCEL, DUMP, and 
DISPLAY (see Chapter 5). 


CANCEL: The operands P1, P2, or P3 specify which parti- 
tion is to be canceled. A job currently being executed from 
the reader queue cannot be canceled by jobname; it can be 
canceled only by specifying the partition in which it is 
executing. 


When a job is canceled by specifying the partition, its 
spooled output is not lost. The output is produced by the 
print and/or punch writer up to the last record prior to 
cancellation. The output is canceled only by entering a 
CANCEL command for that queue (such as CANCEL 
PRTQ,jobname). 


DUMP: \f the system is spooling the printed output for 
the partition being dumped, the dump output also is 
spooled. This dump terminates with the normal end-of- 
step message; processing of the next job for that partition 
can be resumed by responding to the end-of-job message. 


DISPLAY: \t is often helpful for the operator to display 
the system history area to determine the past or current 
activity of the partition (DISPLAY HISTORY). 


The HISTORY operand causes the contents of the system 
history area to be displayed on the CRT similar to the 
following example. For 5704-SC2, history can also be 
displayed by individual tasks. 


fon SYSTEM HISTORY DISPLAY 


display line 2 


display line 3 


display line 11 


ENTER DISPLAY REQUEST MSG NOT RSP om 





The top line controls the direction of the display. 


F ) Forward 
f=<B Backward 
ag Cancel the display 


nn applies to the F and B functions and specifies how many 
lines to roll each time the ENTER key is pressed. For 
example, F10 means to roll the display forward 10 lines. 

If nn is not entered, 10 is assumed. 
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PRINTING 


The print writer is the portion of spooling support that 
prints records on the 1403 Printer from the print output 
queue that was built during job execution (see Figure 2-4). 


Once the print writer has begun printing output from the 
print queue, it continues until one of the following occurs: 


1. All steps on the queue have been printed, or all steps 
on the queue of the specified forms type have been 
printed. 


2. The operator enters a STOP PRT command to ter- 
minate printing. 


3. A cancel option is selected for a printer diagnostic 
message. 


4. The print queue is held (HOLD command) and at a 
later time is released (RELEASE command). 


5. Each job step on the print queue is held (HOLD 
command). 


If autowrite was specified during system generation, opera- 
tor intervention is not required to resume printing for 1, 
4, and 5. The print writer resumes printing automatically 
when output is available on the print queue. 


If autowrite was not specified during system generation, 
the operator responds to the message PRTQ IS EMPTY/ 
HELD to resume printing for 1, 4, and 5. 


For 2 and 3, operator intervention is always required to 
resume printing; this is done by entering a START PRT or 
RESTART PRT command. 


Output on the print queue is identified by jobname and 
stepname. Jobs, job steps, or the entire queue can be held, 


canceled, or displayed. If a job step is not in the keep state, 


it is removed from the print queue after all copies for that 
step have been printed. 


The priority of a step on the print queue is the same as 
that for the executed job, unless a different priority is 
specified with a PRINTER OCL statement. For example, 
if a job has a priority of 3, then the priority of each step 
of that job on the print queue is also 3; but if a step has a 
priority of 1 assigned viaa PRINTER OCL statement, all 
but that step will have a priority of 3. By changing the 
priority of a step on the queue, the operator can print a 
step’s output in a sequence different than the sequence in 
which it was placed on the queue (CHANGE commana). 
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If autostart was specified during system generation, the 
print writer begins when spooling is activated at IPL. If 
print records are not available and autowrite was specified 
during system generation, the print writer waits to begin 
printing output until output becomes available on the 
print queue. If print records are not available and auto- 
write was not specified during system generation, the 
message PRTO IS EMPTY/HELD is displayed, 


If autostart was.not specified, the print writer must be 
started by the operator using the START PRT command. 
Printed output is taken off the print queue ona step 
basis allowing the operator to print a step’s output out of 
the normal sequence. 


If time recording was specified during system generation, a 
message is written in the system history area each time the 
print writer completes printing a job step’s output. The 
message will contain the date and time that the first record 
was printed, and the time the last record was printed. 


More than one time recording message can be written in 
the system history area for each print step. 


When a HOLD, RESTART, or STOP command is entered 
for an active print step, a time recording message is written 
in the system history area. If more than one of these com- 
mands is entered in succession, a time recording message is 
written only for the first command. A message is also 
written if a cancel option is taken to a printer error message. 


If multiple copies are printed, a separate message is written 
for each copy. 


When a retry option is taken to the ALIGN FORM TO 
LINE 1 message, the time recording message is not written 
even though the job step’s printed output is again started 
from the beginning. 
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in the jobs, more entries are placed in the 
print queue and punch queue. 
Print or punch output for a job step is 


Figure 2-4. Starting the Print and Punch Devices 


DEFER Option 


Although the print writer normally prints output produced 
by job steps that have completed execution, it has the 
capability of printing a step’s spooled print records during 
the execution of the step. The DEFER parameter can be 
specified in the PRINTER OCL statement to indicate that 
printing of the spooled output can begin while the step is 
still executing. When DEFER-NO is specified, the print 
writer begins printing the step’s output if it is next on the 
print queue. If the DEFER parameter is not given, the 
system defaults to DEFER-YES, and the step’s output is 
not printed until the step has completed execution. 
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Spool File 


DEFER-YES allows the operator to be sure that a job 
step has been successfully executed or terminated before 
printed output begins. |f a problem occurs during execu- 
tion, the printed output can be canceled without wasting 
time and paper printing the report. 


A throughput improvement can be realized when using 
DEFER-NO for long-printing job steps. For example, a 
job step that executes 1 hour and prints 1 hour requires 

2 hours with DEFER-YES — 1 hour of execution followed 
by 1 hour of spooled printing. With DEFER-NO, the 
print writer can be started shortly after execution starts; 
now, the time required for execution and printing is 
slightly more than 1 hour. 
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Spool File Security 


For 5704-SC2, the QCOPY parameter of the PRINTER 
OCL statement allows print steps to be protected from 
access by the spool file copy program. If QCOPY-NO is 
specified, that print step cannot be copied by the spool 
file copy program; if QCOPY-YES is specified, the copy is 
allowed. 


Grouping Job Steps 


For 5704-SC2, the CLOSE parameter of the PRINTER 
OCL statement allows you to group several of a job’s print 
steps as one step with one stepname. If CLOSE-NO is 
specified, no further print steps of that job are closed at 
end of step; but they are closed at end of job. If 
CLOSE-YES is specified, a print step is closed at end of 
step. 


When a print step is not closed at end of step, a command 
to cause a skip to a new page is placed in the spool file. 


If a previous print step specified CLOSE-NO, a PRINTER 
OCL statement with an ALIGN, COPIES, DEFER, 
FORMSNO, PRIORITY, or QCOPY parameter is ignored 
and causes an information message. 


Restarting the Print Writer 


The RESTART PRT command causes the print writer to 
stop printing output from the current job step, then restart 
from the beginning of any page of that step. A STOP PRT 
command is not required prior to issuing a RESTART 
PRT command; however, a RESTART PRT command can 
be issued following a STOP PRT command. 


Prior to restarting the current job step’s printed output, 
the print writer issues a message (PRT RESTART 
PENDING), giving the operator an Opportunity to correct 
the condition that caused the RESTART command to be 
entered. Response to this message restarts the printing. 


Changing Forms 


Spooling support for the printer also has facilities available 
to aid the operator in changing forms. The forms required 
by a job step may be specified as the FORMSNO parameter 
on the PRINTER OCL statement when the step is submit- 
ted for execution. When the FORMSNO parameter is not 
given, the system defaults to the forms type specified 
during system generation. Thus, each job step on the print 
queue has a forms type associated with it. 


The forms type can be changed for a job step through the 
use of the CHANGE forms type command (see Chapter 5). 


On nonspooled systems, it is common practice to use a 
PAUSE statement in the job stream to remind the opera- 
tor to change forms. Remember that on a spooled system, 
the PAUSE occurs at execution time, not when printing 
begins. Therefore, PAUSE statements used for this pur- 
pose should be changed to PRINTER statements. 


The print writer can be started by keying the START PRT 
command with or without the optional forms type 
operand. However, when starting without the forms type 
operand, the print writer must determine if the forms 
required for this step differ from the forms used by the 
previously printed step. (Note that the previous printed 
step may or may not be in the same job.) 


If a forms change is necessary, a message CHANGE FORM 
TO TYPE nnn is displayed on the CRT identifying the 
forms to be placed in the printer. The print writer does 
not continue until the operator has responded that the 
proper forms have been inserted in the printer. 


The response to the forms change message also indicates 
if separator pages (Figure 2-5) are desired. A O-option 
provides no separator pages; a 1-option provides three 
separator pages before the output of each job step and 
contains the jobname and stepname. Separator pages are 
produced for each step until another message (CHANGE 
FORM TO TYPE nnn) is displayed. 


XX XXX XAXK XXX AKKKXXXXKKXXXKKKX XX KKK XX KKK KX KX KKXXXKKKKKKK 
XXXXXKKXKXXXXKXXXKKKX XX XK XK XXXKKXXKXKKXX XX KK KX XK KKK KKK KKK 
XXAXKKXXXXXKXXXXKKXXXXXXKXXXXXKXXXXXKXXXXXKKKXXKXKKKXX KKK KKK 
XAXKKK XX XXKAKKXXXKKXXXKAKKKXXXKKXXXKKKXXXXXKKAXKK KKK KKK KK KK 
XXXXXKKXXXXX XXX XKXXKXXXXXXKK KKK KX XX XXX KKK KK XXX KX KKK KK KKK 
XXAXKXXXXXKXXKXXXXKXXXXXXXXXKXXX XXX XXKX KKK XK XXXKXXKXXXXXKK 


Figure 2-5. Separator Page Output 
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JOBNAME 
JOBNAME 
JOBNAME 
JOBNAME 
JOBNAME 
JOBNAME 


STEPNAME 
STEPNAME 
STEPNAME 
STE PNAME 
STEPNAME 
STEPNAME 


XAXKXXXXAKKKAKKXRAKKAXRKAKARKAKXKKKAX KK EKA K MAX KKK AX KK KKK 
XXXX XXX XXX KX KKK KX KAKA AK KKK KKK XK K KKK KKK KU XKX KKK KK KXKK 
XXXXKKAXKKAKXAKKKXKXXAAXKXXXKAKXKXKXKXXXKXXAKKAKKKAXKAXKAXKAX 
XXXXKXMXK KK XK KKK KXNKAK KKK KAA KK KKK X KX KKK KKK KO KXK KX KX KKK KA 
XXAXXXKXXXXXXKANKXKXKXXKXKKAKXXAXXKKXXXKXXXKKXKXKKXKXAXXKXKXKK 
XXXKXK KK XK X KKK KKK KKK XK KK KKK KKK KKK XK KAR KKK ERK KX KKK KX KKK 


Starting the Print Writer Using a Forms Type 


The print writer can be started by placing the forms type 
operand in the START command. For example, 
START PRT,forms type causes the print writer to print 
only those job steps in which the forms type matches that 
given in the START command. A message, CHANGE 
FORM TO TYPE nnn, is displayed on the CRT only for 
the first job step to print after the START command is 
given. If the printer has printed a job step with the same 
forms type as specified in the START PRT,forms type 
command, the CHANGE FORM TO TYPE nnn message 
is not displayed. 


If autowrite has not been specified and the print writer has 
printed all job steps on the print queue with the specified 
forms type, the message PRTO IS EMPTY/HELD TYPE nnn 
is written to the CRT. Additional steps placed on the print 
queue of the forms type nnn can be printed by responding 
to this message. 


When autowrite has been specified, the message is not 
issued, and the print writer waits for additional jobs of 
forms type nnn to be placed on the print queue before it 
resumes printing. 


To change the forms type with which the print writer is 
printing, the print writer must first be terminated 

(STOP PRT), then started using a new forms type with the 
START command. A job step being printed when the 
STOP PRT command is entered is retained on the print 
queue. 


Forms Alignment 


Two aids are available for aligning forms prior to and 
during a job step’s printed output: 


1. The ALIGN parameter can be specified on the 
PRINTER OCL statement when the step is submitted 
for execution. This allows forms alignment prior to 
printing a job step’s output. 


2. The RESTART PRT command can be used to restart 
a job step’s printed output. 


\f ALIGN-YES was specified on the PRINTER OCL state- 
ment, the print writer prints the first line and displays a 
message, ALIGN FORM TO LINE 1, onthe CRT. The 


operator, by responding to this message, may choose to 
repeat the alignment procedure or continue printing the 
step’s output. (ALIGN-YES also applies to multiple 
copies and if output is restarted at the beginning.) 


tf the forms must be aligned during printing, the STOP 
PRT command may be entered to stop the print writer. 
At this time the forms can be aligned, after which the 
START PRT command is entered, causing the print writer 
to continue printing the output. 


The RESTART PRT command can be entered to restart 
the step’s printed output from the beginning. Prior to 
printing the step’s output, a PRT RESTART PENDING 
message is issued. Response to this message restarts the 
printing. 


lf first page (1P) forms alignment is specified in an RPG II 
program and the printed output is being spooled, the RPG I 
forms alignment is bypassed during execution. Unless a 
PRINTER OCL statement with an ALIGN-YES parameter 
is included in the OCL for the execution of that program, 
the system does not halt to allow the operator to align 

the forms. The OCL option, used with spooling, operates 

in the same manner as the RPG !| option. 


Another way to allow the operator to adjust forms prior to 
spooled output is to use a different forms type for that 
step. This does not give the operator a chance to reprint 
the first line, but the halt allows checking of the forms 
alignment before beginning the printing. 


Multiple Copies 


Either the COPIES parameter on the PRINTER OCL state- 
ment, or the CHANGE copies command can cause more 
than one copy of printed output to be produced from the 
single execution of a job step. All requested copies for a 
job step are produced by the print writer before continuing 
to print the next job step on the queue. Although multiple 
copies are requested, only one copy of the output is in the 
print queue. 


When a dump of main storage has been requested during 
the execution of a step by means of the DUMP command 
or by taking a D option to a message, the dump is included 
with the step’s output in the print queue. !n this case, only 
one copy of the output is printed, even though more copies 
were requested. 
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Changing the Print Chain/Train 


No support is provided by spooling for changing the chain 
image for printed output. Print records that are spooled 
are printed using the currently loaded chain image. Ifa 
special print chain or train is required for a job on a system 
supporting spooling of printed output, the operator should 
use the following procedure (the example assumes that 
partition 1 is being used): 


1. Enter a STOP SPOOL,P1 command. This causes the 
spooling support for the specified partition to terminate 
at the next end-of-job condition. If the partition is 
at end of job, spooling terminates immediately. 


2. Enter a STOP PRT,PAGE command to terminate the 
printing of spooled print records at the end of a page 
and release the printer; or enter a STOP PRT,STEP 
command to allow the current print step to complete 
and then release the printer. 


3. Stop the reader or punch writer if those devices are 
being used by spooling and are required by the 
special job. 


4. Execute the job requiring the special print chain. It 
is suggested that the JOB statement for this job spec- 
ify SPOOL-NO to ensure that the spooling functions 
in that partition have been terminated. Following 
the job’s last step, the IMAGE statement must be 
given to restore the print chain image for the spool 
printed output. The IMAGE statement(s) should be 
followed by a /. statement. 


5. At end of job, spooling for the partition can be re- 
started by entering the START SPOOL,P1 command. 
The desired spool functions (such as reader, print 
writer, punch writer) can then be started. 
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Error Conditions 


When errors (such as a carriage sync check) occur on the 
printer while the spool print writer is active, the operator 
responds to the error as on a nonspooling system. When a 
0- or 1-option is taken, the print writer continues printing 
from where it stopped. A 2- or 3-option causes the print 
writer to terminate; however, the job step remains on the 
print queue. (A CANCEL command removes the job step 
from the print queue.) It is important to note that one line 
of printing may be lost due to the type of error encoun- 
tered. If this occurs, the operator can enter a RESTART 
PRT,PAGE command to start printing from the beginning 
of the page on which the error occurred. 


Unprintable characters within the spooled printed output 
are handled in the manner requested by the user program. 
If the user program requests a message when unprintable 
characters are encountered, a message will be displayed if 
unprintable characters are found when the spooled output 
is printed. However, there are some exceptions: 


t A message will not occur if the step’s printed output 
is preceded by OCL logged to the printer (LOG 
statement). 


2. If the program requests a message in the first record 
of a step to be printed, an unprintable character in 
each succeeding record of the step will also cause a 
message even if one is not requested. If a message is 
not requested in the first record of a step to be printed, 
no message will be given, even if the program requests 
a message in a succeeding record. 


3. A message will not occur if the step’s printed output 
contains a dump and the printing of the step is started 
after end of step occurs. However, a message can 
occur if the step’s printed output contains a dump 
and the printing of the step is started before end of 
step occurs. 


Operator Control 


Operator control commands are used to manipulate and 
monitor the print queue (see Chapter 5). These commands 
are CANCEL, HOLD, RELEASE, CHANGE, STOP, 
REUSE, DISPLAY, and KEEP. 


For 5704-SC2, the CANCEL, HOLD, RELEASE, CHANGE, 
and KEEP commands can also be used to manipulate 

multiple jobs and/or job steps by specifying, in place of the 
jobname/stepname, one to seven characters followed by two 
asterisks (**). Spooling will then perform the requested 
function on all jobs/steps on the queue whose names begin 
with the specified characters. The following are some 
command examples and the results on the print queue if these 
commands are entered: 


Command Result 


HOLD PRTQO,ABC** All jobs whose jobnames 
begin with ABC are held. 
HOLD PRTQ,ABC,12* * All job steps whose 
jobnames are ABC and 
whose stepnames begin 
12 are held. 

HOLD PRTO,ABC***,12*** — All job steps whose 
jobnames begin with 
ABC* and whose 
stepnames begin with 
12* are held. 


CANCEL: The operator can cancel a job on the print 

queue, a step on the queue, or the entire print queue. 
CANCEL *PRTQ does not affect the step currently printing 
or a step currently being placed on the print queue; 

however, a CANCEL PRTQ,jobname command or a CANCEL 
PRTQ,jobname,stepname command can be used to 
immediately terminate the current job or step printing. 


HOLD: This command is used to prevent a job or step 
from printing. It can prevent the entire print queue from 
being printed or it can immediately interrupt the step 
currently being printed. 


RELEASE: The RELEASE command allows the operator 
to release a job, job step, or the entire print queue from 
the hold state. The released job or job step retains the last 
priority assigned to it. 


Jobs or job steps individually held are not released by a 
RELEASE PRTO command; each job or job step must be 
released individually, by name (for exampie, 

RELEASE PRTQ,jobname). 


If the entire queue is held, individual jobs or steps cannot 
be released. (The entire queue must be released.} 


CHANGE: The CHANGE command allows the operator 

to alter the priority, forms type, or number of copies of a 
job or job step on the print queue. The CHANGE command 
does not affect a step currently being placed on the print 
queue. The uses of the CHANGE commands for the print 
queue are as follows: 


@ The CHANGE priority command is useful when the 
operator wants to obtain the output in a sequence 
different from which the output was put on the queue. 


@ The CHANGE forms type command is used to indicate 
the forms type required by the job step if the forms 
type required is different from, or was not specified on, 
the PRINTER OCL statement. The CHANGE forms 
type command does not affect a step currently printing. 


@ The CHANGE copies command is used to change the 
number of output copies to be produced by the job step. 


STOP: By using the STOP PRT command, the operator 
causes the print writer to terminate and free the printer. 
The job step that was currently being printed is kept on 
the print queue and can be continued from the point of 
termination by using START PRT (or START PRT, forms 
type). The print writer can also be restarted from the 
beginning of any page by using the RESTART command. 


The following example illustrates a valuable use for this 
command: Partition 1 has spooling support and the print 
writer is currently printing. Partition 2 does not have 
spooling support and the current job step has just requested 
use of the printer {the same printer is used by both parti- 
tions). The CRT displays the message 1403 NOT AVAIL- 
ABLE. The operator enters the STOP PRT command and 
the message PRT WRITER TERMINATED is displayed. 
The operator responds to the 1403 NOT AVAILABLE 
message. The job step in partition 2 now executes using 
the printer. When this step reaches ES (end of step), the 
operator can resume printing from the print queue with 
either a START PRT or a RESTART PRT,PAGE command. 
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REUSE (5704-SC2 only}: The REUSE command frees space 
in the spool file from the currently printing job step (before 
printing is complete), making that space available for other 
uses. A job step that is in the keep state cannot be reused. 


DISPLAY: The operator determines the status of the 
print queue with the DISPLAY PRTQ command. 


The following is an example of how a display of the print 
queue might appear: Information displayed for the print 
queue is jobname, stepname, position on queue (POS), 
priority (PR), forms number (FRM), number of copies 
(CPY), and number of pages (PAGES). 


PAGES is a display of the total number of pages required 

to print the job step. The spool printer intercept routine 
maintains the page count for the job step as output is being 
placed onto the print queue. The page count is incremented 
by 1 when spooling detects a space or a skip to a new Page. 
if a space or a skip to a new page is the last printer com- 
mand issued by the job step (as in the case of logging the 
end-of-job statement to the printer which issues a skip 

after printer command), the page count appears to be 
incorrect by 1. This last movement to a new page is counted 
even though no further printing occurs. A page count up 

to 65,535 pages can be displayed. When 65,536 is reached, 
the page counter is reset to 0; thus, O indicates page 

65,536 and 1 indicates 65,537. 


If the print writer was started using a forms type, that 
forms type will be displayed in the message nnn IS ACTIVE 
FORMS TYPE. 


FLO PRT QUEUE (H) POS PR FRM CPY PAGES 
+ “-~nnn IS ACTIVE FORMS TYPE--- 

PAYROLL CHECKS 1 H4 CKS 1 100 

REGISTER 2KA4 STK 3 99 

YTDMASTR 3 K4& STK 1 25 
ACCOUNTS DUE 4KQ3 STK 1 325 
PAYABLE 5 R3 SPL 3N 850 
LABOR 6 2 31 

END OF QUEUE 


MANHOURS 


ENTER DISPLAY REQUEST MSG NOT RSP on 





Line 1 controls the scrolling of the display. 
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If, after displaying the contents of one queue using the 
DISPLAY command, the operator wants to display the 
contents of another queue, the operand for the alternate 
queue is entered in the first two or four positions of line 1. 


For example, to display the reader queue, RDROQ is 
entered in the first four positions, or RQ is entered in the 
first two positions. The ENTER key is pressed, and the 
reader queue is displayed. 


An (H) on the first line of the display indicates that the 
entire print queue is held via the HOLD command. 


One or two of the following characters can precede the 
priority number in the display: 


A -- Indicates that the job step is currently being printed 

H — Indicates that the job or job step is being held via 
the HOLD command 

K — Indicates that the job or job step is in a keep state 
via the KEEP command (5704-SC2 only) 

Q — Indicates that the job or job step is being copied 
by $COPY (5704-SC2 only) 

R — Indicates that the job step was partially canceled 
with a REUSE command and is no longer being 
printed (5704-SC2 only) 


An asterisk (*) after the number of copies indicates that 
the job step is executing and DEFER-NO was specified on 
the PRINTER OCL statement for the job step. A job step 
that is executing without DEFER-NO specified is not 
displayed. For 5704-SC2, an N after the number of copies 
indicates that the job step cannot be copied with the spool 
tile copy program (QCOPY-NO specified on the PRINTER 
OCL statement). 


KEEP (5704-SC2 only): The KEEP command is used to 
prevent a job step from leaving the print queue afier a 

copy for that step has been printed. Rather, the job step 
remains on the queue in the hold state. If the job step has 
multiple copies, one copy is printed, the number of copies is 
reduced by one, and the job step remains on the queue in the 
hoid state. A job step that has been reused with the REUSE 
command cannot be kept. 


Displaying the Current Printed Page Count 


To determine the number of the page currently being 
printed, the operator can enter a STOP PRT command. 
This causes a 


PRT WRITER TERMINATED PAGE nnannn 
message, where nnnnn is the number of the current Page. 


If the operator enters a START PRT command following 
this message, the print writer continues from where it was 
stopped. 


Printing the Last Pages First 


To check the end of a long printed report before all of the 
report is printed, you should: 


1. Use a CHANGE command to increase the number of 
copies by 1. The number of copies will be decreased 
by 1 after the last page is printed. 


2. Start printing the first page to ensure that the report 
is the next one on the queue to be printed. 


3. Enter a RESTART PRT,nnnnn command, where 
nnnnn is a page number close to the end of the report. 


4. To stop the writer at the end of this copy, enter a 
STOP PRT,STEP command at the PRT RESTART 
PENDING message or while the pages are being printed. 
This allows you to inspect the end of the report 
before deciding whether to print the entire report 
at this time, print it later, or cancel it from the queue. 


Skipping Back Several Pages 


You may wish to skip back several pages after a forms jam 
or any other printer error. To do this, take a 2- or 3-option 
to the printer error message; this action causes a PRT 
WRITER TERMINATED PAGE nnnnn message, where 
nnnnn is the current page number. You can now subtract 
the number of pages to be skipped back and enter a 
RESTART PRT,nnnnn command, where nnnnn is the 
resulting page number. 


PUNCHING 


The punch writer is the portion of spooling support that 
punches cards from the punch output queue that was built 
during job execution. 


When the punched output of a step or a copy of punched 
output is complete, a message, END OF PCH STEP, is 
displayed on the CRT, notifying the operator that the 
punched cards can be removed from the stacker(s). On the 
2560 or 1442, cards are fed from the hopper causing cards 
in the feed path to be placed in the stacker(s). The operator 
does not need to initiate nonprocess runout (NPRO). The 
response to the message causes the next copy of the job 
step or the next job step on the punch queue to be started. 
Separator cards are not inserted between steps. 


The punch writer continues to produce output in this man- 
ner until one of the following occurs: 


1. All steps on the punch queue are punched. 
2. A STOP PCH command is entered. 


3. A cancel option is selected for a punch diagnostic 
message. 


4. The entire queue is held (HOLD command) and at a 
later time is released (RELEASE command). 


5. Each step is held (HOLD command). 


‘Hf autowrite was specified during system generation, oper- 


ator intervention is not required to resume punching for 
1,4, and 5. The punch writer resumes punching automat- 
ically when output is available on the punch queue. 


If autowrite was not specified during system generation, 
the operator responds to the message PCHO iS EMPTY/ 
HELD to resume punching for 1, 4, and 5. 


For 2 and 3, operator intervention is always required to 
resume punching; this is done by entering a START PCH 
or RESTART PCH command. 


Output on the punch queue is identified by jobname and 
stepname. Jobs, job steps, or the entire queue can be held, 
canceled, or displayed. If a job step is not in the keep state, 
it is removed from the punch queue after all copies for that 
step have been punched. 
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The priority of a step on the punch queue is the same as the 
job that was executed, unless a different priority is speci- 
fied with a PUNCH OCL statement. For example, if a job 
has a priority of 3, then the priority of its output on the 
punch queue is also 3; but if a step has a priority of 1 
assigned via a PUNCH OCL statement, all but that step will 
have a priority of 3. By changing the priority of a step on 
the queue, an operator can punch a step’s output ina 
sequence different from the sequence in which it was placed 
on the queue (CHANGE command). 


If autostart was specified during system generation, the 
punch writer begins when spooling is activated at IPL. If 
punch records are not available and autowrite was specified 
during system generation, the punch writer waits to begin 
punching output until output becomes available on the 
punch queue. If punch records are not available and auto- 
write was not specified during system generation, the mes- 
sage PCHO IS EMPTY/HELD is displayed. 


If autostart was not specified, the punch writer must be 
started by the operator using a START PCH command. 
Punching of spooled data cannot begin until the reader 
has terminated. 


If time recording was specified during system generation, a 
message is written in the system history area each time the 
punch writer completes punching a job step’s output. The 
message will contain the date and time that the first record 
was punched, and the time the last record was punched. 


More than one time recording message can be written in the 
system history area for each punch step. 


When a HOLD, RESTART, or STOP command is entered 
for an active punch step, a time recording message is written 
in the system history area. If more than one of these com- 
mands is entered in succession, a time recording message is 
written only for the first command. A message is also 
written if a cancel option is taken to a punch error message. 


When multiple copies are punched, a separate message is 
written for each copy. 
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DEFER Option 


While the punch writer normally punches output produced 
by job steps that have completed execution, it can also 
punch a step’s spooled punch records during the execution 
of the step. The DEFER parameter can be specified in the 
PUNCH OCL statement to indicate that punching of the 
spooled output can begin while the step is still executing. 
When DEFER-NO is specified, the punch writer begins 
punching the step’s output if it is next on the punch queue. 
If the DEFER parameter is not given, the system defaults 
to DEFER-YES, and the step’s output is not punched until 
the step has completed execution. 


DEFER-YES allows the operator to be sure that a job step 
has been successfully executed or terminated before 
punched output begins. If a problem occurs during exe- 
cution, the punched output can be canceled without 
“asting the time and cards needed to punch the output. 


Use of DEFER-NO can improve throughput. For example, 
a Job step that executes 1 hour and punches 1 hour requires 
2 hours with DEFER-YES — 1 hour of execution followed 
by 1 hour of spooled punching. With DEFER-NO, the 
punch writer can be started shortly after execution starts. 
Now, the time required for execution and punching is 
slightly more than 1 hour. 


Spool File Security 


For 5704-SC2, the QCOPY parameter of the PUNCH OCL 
statement allows punch steps to be protected from access 
by the spool file copy program. If QCOPY-NO is specified, 
that punch step cannot be copied by the spool file copy 
program; if QCOPY-YES is specified, the copy is allowed. 


Restarting the Punch Writer 


The RESTART PCH command causes the punch writer to 
stop punching from the current job step and immediately 
restart from the beginning of that step. A STOP PCH com- 
mand ts not required prior to entering a RESTART PCH 
command; however, a RESTART PCH command can be 
entered following a STOP PCH command. 


Prior to restarting, the punch writer issues a message (PCH 
RESTART PENDING) to give the operator an opportunity 
to correct the condition that caused the RESTART 
command to be entered. 


Reading and Punching 


The punch writer and input reader cannot operate simul- 
taneously. When a job stream is being read to the reader 
queue, the punch writer cannot punch from the punch 
queue. Likewise, when the punch writer is operating, the 
reader cannot put jobs on the reader queue. OCC commands 
are available for stopping and starting the punching and 
reading functions. 


Changing Card Types 


Spooling support for the punch has facilities that inform the 
operator to use a different card type for a particular step. 
The card type required by a job step can be specified in the 
CARDNO parameter on the PUNCH OCL statement when 
the step is submitted for execution or with the CHANGE 
card type command after the job step has been placed on 
the punch queue. When the CARDNO parameter is not 
given, or the card type has not been changed by the 
CHANGE command, the system defaults to the card 

type specified during system generation. Thus, each job 
step on the punch queue has a card type associated with it. 


When the punch writer prepares to process the output from 
a job step, it determines whether the card type required 

for the current step agrees with the card type used by the 
previously punched step. (Note that the previously 
punched step might not be from the same job.) 


If the card types are not the same, the punch writer issues 
a message, CHANGE CARD TO TYPE nnn, informing the 
operator that a different card type is required. The punch 
writer does not continue until the operator has responded 
to the message. 


Multiple Copies 


The COPIES parameter on the PUNCH OCL statement can 
cause multiple copies of the punched output to be pro- 
duced from the single execution of a job step. After the 
job step has been placed on the punch queue, the CHANGE 
copies command can be used to change the number of 
copies of output produced by a job step. Although 
multiple copies are requested, only one copy of the output 
is in the punch queue. 


After punching one copy of a job step’s punched output, 
the punch writer issues a message (END OF PCH STEP) 
allowing the punched cards to be removed from the stack- 
er(s). Response to the message causes the punch writer to 
produce the next copy and continue in this manner until 
all copies have been punched. 


When a dump of main storage has been requested during 

the execution of a step by means of the DUMP command 

or by taking a D-option to a message only one copy of the 
output is punched, even though more copies were requested. 


Error Conditions 


When errors (such as a feed check) occur on the punch 
device and the punch writer is active, the operator responds 
to the error in the same way as on a nonspooling system. 
When a 0- or 1-option is taken, the punch writer continues 
punching from where it stopped. A 2- or 3-option causes 
the punch writer to terminate; however, the job step 
remains on the punch queue. (A CANCEL command 
removes the job step from the punch queue.) Depending 
on the error condition and recovery procedure, one 
punched card may be invalid or lost. If this occurs, the 
Operator can enter a RESTART PCH command to start 
punching from the beginning of the job step. 
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Operator Control of Punch Spooling 


Operator control commands are used to manipulate and 
Monitor the punch queue (see Chapter 5). These commands 
are CANCEL, HOLD, RELEASE, CHANGE, STOP, REUSE, 
DISPLAY, and KEEP. 


The CANCEL, HOLD, RELEASE, CHANGE, and KEEP 
commands can also be used to manipulate multiple jobs 
and/or job steps by specifying, in place of the 
jobname/stepname, one to seven characters followed by two 
asterisks (**). Spooling will then perform the requested 
function on all jobs/steps on the queue whose names begin 
with the specified characters. The following are some 
command examples and the results on the punch queue 

if these commands are entered: 


Command Result 


HOLD PCHO,ABC** All jobs whose jobnames 
begin with ABC are held. 
HOLD PCHO,ABC,12** All job steps whose 
jobnames are ABC and 
whose stepnames begin 
with 12 are held. 
HOLD PCHO,ABC***,12*** — All job steps whose 
jobnames begin with 
ABC* and whose 
stepnames begin with 
12” are held. 


CANCEL: The operator can cancel a job on the punch 
queue, a step on the queue, or the entire punch queue. 
CANCEL *PCHO does not affect the step currently being 
punched or a step currently being placed on the punch queue; 
however, a CANCEL PCHQ,jobname command or a CANCEL 
PCHQ,jobname,stepname command can be used to immed- 
iately terminate the current job or step punching. 


HOLD: The HOLD command can prevent all jobs and 
steps on the punch queue from being punched. A single 
step, a complete job, or the entire punch queue can be 
held. If a job or step is held on the punch queue when 
that job or step is being punched, it is put back on the 
queue and the next step is punched. 


RELEASE: The RELEASE command provides the means 
to free a job, a step, or the entire punch queue after it was 
put in the hold state. Jobs or steps that were individually 

held must be released individually; they cannot be reteased 
with one RELEASE PCHO command. 
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If the entire queue was held, individual jobs or steps 
cannot be released; the entire queue must be released. 


CHANGE: The CHANGE commands allow the operator 
to alter the priority, card type, or number of copies of a 
job or job step on the punch queue. The CHANGE 
command does not affect a step currently being placed 
on the punch queue. 


The uses of the CHANGE commands for the punch queue 
are as follows: 


@ The CHANGE priority command }5 useful when the 
operator wants punched output in a sequence different 
from the sequence on the queue. 


@ The CHANGE card type command is used to indicate 
the card type required by the job step if the card type 
required is different from, or was rot specified, on the 
PUNCH OCL statement. The CHANGE card type com- 
mand does not affect a step currently punching. 


@ The CHANGE copies command is used to change the 
number of output copies to be produced by the job step. 


Consider this exampie, which iliustrates how the CHANGE 
priority command might be used: 


Partition 1 is supported by punch spooling and the punch 
queue has two steps: STEP1 requires 30 minutes of 
punching and STEP2 requires 5 minutes of punching. 


Partition 2 is not supported by spooling and is currently 
executing JOBA which requires another 10 minutes to be 
completed. When JOBB starts execut ng, it will require 
the data contained in STEP2 


The operator can use the CHANGE priority command to 
give STEP2 a higher priority than STEP1. STEP2 can now 
be punched and the output be made available for JOBB. 


STOP: The STOP PCH command allows the operator to 
terminate the punch writer and free the spooled punch 
device. The step that was currently being punched is kept 
on the queue and can be continued from the point of 
termination with the START PCH cornmand or restarted 
from the beginning of the step with the RESTART PCH 
command. When STOP PCH,STEP is entered, the punch 
writer terminates after the step or copy has completed 
punching. 


The STOP command can minimize device contention with 
both a nonspooled partition and a spooled reader device. 
Consider the following two examples: 


1. The punch writer is currently punching cards on the 
1442 for partition 1. The program in partition 2 is 
not spooled and has requested the use of the 1442. 


A message is displayed on the CRT indicating that 
the 1442 is not available for partition 2. The operator 
enters a STOP PCH,STEP command to stop the 
punch writer when the punching is completed for 
the current step or copy. When completed, the 
message PCH WRITER TERMINATED is displayed. 
The operator then responds to the partition 2 
message, and the job step in partition 2 can now use 
the 1442. At the completion of this step, the 
operator enters a START PCH command to cause 
punching to resume from the punch queue. 


2. The system has input and punch spooling, with the 
2560 specified as both the reader and punch device. 
(Partition 2 is being used for an online inquiry 
application.) The punch writer is currently punching 
and the operator has just received a top priority job 
to be executed immediately. 


The STOP PCH command terminates punching 
immediately. The rush job is placed in the 2560, 
and aSTART RDR command is entered. After the 
job has been spooled to the reader queue, the mes- 
sage SPOOL RDR TERMINATED is displayed, and 
the operator responds to the ES or EJ message to 
start job execution. A START PCH command can 
be entered to resume punching from the punch 
queue. 


REUSE (5704-SC2 only): The REUSE command frees space 
in the spool file from the currently punching job step (before 
punching is complete), making that space available for other 
uses. A job step that is in the keep state cannot be reused. 


DISPLAY: The DISPLAY command is useful in displaying 
the current status of the punch queue. In the preceding 
examples, the display could have been used to find out 
what steps were on the punch queue and what their priori- 
ties were. The operator could also have used the display 
function after manipulating the queue to ensure that every- 
thing was correct. 


The following is an example of the punch queue display. 
Information displayed for the punch queue is jobname, 
stepname, position on queue (POS), priority (PR), card 
number (CRD), number of copies (CPY}, and number of 
cards (CARDS). 


F10 PCH QUEUE (H) POS PR CRD CPY CARDS 


PAYROLL YTDMASTR LKA3 123 1 27 
WKMASTR 2 R3 123 3N 100 
ACCOUNTS PAYABLE 3 3 BLK 1* 326 


END OF QUEUE 


ENTER DISPLAY REQUEST MSG NOT RSP oan 





An (H) on the first line of the display indicates that the 
entire punch queue is held via the HOLD command. 


One or two of the following characters can precede the 
priority number in the display: 


A — Indicates that the job step is currently being 
punched 

H — Indicates that the job or job step is being held via 
the HOLD command 

K — Indicates that the job or job step is in a keep state 
via the KEEP command (5704-SC2 only) 

Q — Indicates that the job or job step is being copied 
by $QCOPY (5704-SC2 only) 

R — Indicates that the job step was partially canceled 
with a REUSE command and is no longer being 
punched (5704-SC2 only) 


An asterisk (*) after the number of copies indicates that the 
job step is executing and DEFER-NO was specified on the 
PUNCH OCL statement for the job step. A job step that 

is executing without DEFER-NO specified is not displayed. 
For 5704-SC2, an N after the number of copies indicates 
that the job step cannot be copied by the spool file copy 
program (QCOPY-NO specified on the PUNCH OCL 
statement). 


KEEP (5704-SC2 only): The KEEP command is used to 
prevent a job step from leaving the punch queue after a 

copy for that step has been punched. Rather, the job 

step remains on the queue in the hold state. If the jcb 

step has multiple copies, one copy is punched, the number 
of copies is reduced by one, and the job step remains on the 
queue in the hold state. A job step that has been reused with 
the REUSE command cannot be kept. 
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Chapter 3. Processing without Spooling 


There may be situations when the operator or system pro- 
grammer chooses to run without spool support even though 
it is included in the system. The following are some rea- 
sons for not using spool support: 


@ A job stream has very little card input or card or printer 
output. 


@ Jobs require combined files (specifying print or punch 
operations on the input card files). 


@ The input card files use stacker selection. 

@ The printer chain image must be changed frequently. 
@ Card files are merged. 

There are two ways to process a job without spooling: 


@ At IPL, the operator can enter a CANCEL SPOOL 
command; this command is in effect until another IPL. 


@ The operator can enter a STOP SPOOL command: this 
command is in effect until a START SPOOL command 
is issued. 


The JOB OCL statement can contain the SPOOL-NO param- 
eter. Use of this parameter only ensures that the job is not 
executed when spooling is active. (SPOOL-NO does not 
affect spooling.) 
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CHECKPOINT/RESTART 


Checkpoint/restart is an optional facility of the system 
control program (SCP) that can be included in your sys- 
tem during system generation. Used with an object pro- 
gram, such as COBOL, the checkpoint function records 
the status of the program at specified intervals. If process- 
ing is terminated before normal end of job, the program 
can be restarted from the last checkpoint rather than from 
the beginning. 


The following conditions are necessary to allow checkpoints 
to be taken. All of these conditions are necessary for taking 
a checkpoint; if any of these conditions do not exist, the 
checkpoint program can be executed, but checkpoints are 
ignored: 


@ The checkpoint program must be executed in partition 1. 
@ Spooling must not be active in partition 1. 


@ Unit-record devices required by the checkpoint program 
cannot be used by the spool reader or writers. 


if spooling is active, the job can be prevented from running 
by specifying SPOOL-NO on the JOB statement. If SPOOL- 
YES is specified (or if SPOOL-NO is not specified), and if 
the checkpoint program is allowed to run with spooling ac- 
tive in partition 1, then checkpoints are ignored. 


Prior to executing a checkpoint program, the operator can 


stop spooling in the partition by using the STOP SPOOL,P1 
command. 


The JOB statement should also specify PARTITION-1. 
This prevents the checkpoint program from being allowed 
to run in another partition where checkpoint requests are 
ignored. 


The following example suggests an operating procedure that 
can be used when executing a checkpoint program: 


Assume that the 2501 is the spooled reader, the 1442 is the 
spooled punch, and the 1403 is the spooled printer; also, 
assume that the checkpoint program reads cards from the 
1442 and prints on the 1403. 
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The OCL could be the following: 


// JOBO1 JOB SPOOL-NO,PARTITION-1 

// PAUSE ENTER... STOP,PRT... STOP,PCH 
// LOAD CHKPT,F1 

// RUN 


The JOB statement ensures that the program is executed 
only in partition 1 with spooling stopped in that partition. 


The PAUSE statement reminds the operator to stop the 
spooled punch and printer if they are active. When this 

is done, the operator responds to the PAUSE message, and 
the checkpoint program can be executed. 


To reactivate spooling after the checkpoint program is 
finished, the operator can use the following commands: 


START SPOOL,P1 
START PRT 
START PCH 


When restarting from a checkpoint, the required devices 
must be available and spooling must be stopped in partition 
1. The OCL could be the following: 


// JOBO2 JOB PARTITION-1,SPOOL-NO 

// PAUSE ENTER... STOP,PRT... STOP,PCH 
// LOAD $$RSTR,F1 

// RUN 


If spooling is active in partition 1 when restarting a program, 
a diagnostic message is issued to force the restart request to 


be canceled. The operator can enter STOP SPOOL,P1 and 
reenter the restart job. 
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ROLLOUT/ROLLIN 


Rollout/rollin ane optional facility of the system control 
program (5704-SC1 only) and can be included in your 
system during system generation. Used with an object 
program, such as RPG I! or FORTRAN, the rollout/rollin 
function provides a means of interrupting (rolling out) one 
program to allow another program to be executed. When 
the interrupting program is finished, the interrupted one is 
reinstated (rolled in) to continue executing. 


A rollout is requested by means of the operator control 
command ROLLOUT, or simply RO. A rotlout can be re- 
quested even while spooling is active; however, any unit- 
record devices Heing used by spooling must be released via 
OCC and made available to the interrupting program. 


| 
Note: Rollout/rollin can be used in partition 1 only. 


Consider an example in which the 1442 is the spooled punch 
device and the 1403 is the spooled print device. In this ex- 
ample, the interrupting program reads cards from the 1442 
and prints on the 1403: 


1. The user énters the ROLLOUT command. A message 
(CC JY RDP) is displayed, giving the user the oppor- 
tunity to either cancel the rollout request or con- 
tinue with the interruption. A O-option allows the 
rollout request to continue. 





2. The user anters commands to stop the print and 
punch writers (STOP PRT and STOP PCH). 





Asa result, the 1403 and 1442 can be used by the 
aE program. 
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When the system displays ENTER READER DATA 
P1, the user can enter OCL statements for the inter- 
rupting program. Since the interrupting program reads 
cards from the 1442, it may be necessary to change 
the system input device by enteringa READER 
statement. 


The interrupting program is executed. Because rollin 
is pending, output from the interrupting program can- 
not be spooled. 


At the completion of the interrupting program, a 
message (CC J’ RD) is displayed, informing the user 
that the interrupted program is about to be resumed. 
After preparing the 1442 and 1403, the user responds 
to the message with a 0-option. 


The user enters commands to restart the print and 
punch writers (START PRT and START PCH). 


The execution of the interrupted program resumes. 


Operator control commands (OCC) are available for moni- 
toring, controlling, and communicating with the spooling 
function. The operator enters OCC using the C RT/key- 
board. The following commands can be entered in a 
spooling environment: 


CANCEL 
CHANGE 
DISPLAY 
HIPTY 
HOLD 
KEEP 
PTY 
READER 
RELEASE 
RESTART 
REUSE 
START 


STOP 


The following conventions are used to illustrate the 
commands: 


1 Uppercase letters and punctuation marks (except 
brackets, braces, and parentheses) must be entered 
exactly as shown. 


2. Lowercase letters and terms represent variable infor- 
mation that you supply depending on the operation 
you want to perform. 
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3. One or more items within brackets { ] indicate an 
optional choice. You can include one item or omit 
the entire operand as required by the operation you 
are performing. 


4. Items in braces {| } indicate a required choice. You 


must enter one of the items. 


5. Optional items that are underlined indicate the de- 
fault value. If none of the items is entered, the de- 
fault value is used. 


6. Abbreviations, if applicable, are enclosed in parenthe- 
ses () below the operation or operand. These abbre- 
viations can be entered in place of the keywords. 


re Parameters in the commands are positional and must 
be entered in the order shown in this chapter. Ifa 
positional parameter is left out between other param- 
eters, the comma must not be omitted. 


In the following OCC descriptions, when a jobname or a 
jobname and stepname are used, the requested action is 
performed on all jobs or steps on the queue that use the 
name you enter. 


Note: \f the jobname or stepname in the OCL contains 


characters which are not on the 3277 keyboard, that job 
or job step cannot be referenced by name when using OCC. 
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CANCEL 


This command takes effect immediately. 


Functions 
@ Cancels spooting. 


@ Cancels the reader queue or one or more jobs on the 
reader queue. 


® Cancels the print queue, one or more jobs on the print 
queue, or one or more jobs steps on the print queue, 


® Cancels the punch queue, one or more jobs on the punch 
queue, or One or more job steps on the punch queue. 


Note: The preceding functions are valid only for sys- 
tems that support spooling. 


® Cancels a program that is executing in a partition. 


Format 


Operation Operand 


CANCEL SPOOL 
(CN) (SP) 


jobname \ 


BORO eden 


(RQ) 


jobname »stepname 
ae oes : } | 


jobname ,stepname | 
oe es Peau 


*RDRQ 
(*RQ) 


*PRTQ 
(*WQ) 


*PCHOQ 
(*PQ) 
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Contents 


SPOOL (SP): This operand can be specified at IPL prior 
to spooling being activated. The main storage used by the 
spooling routine is made available to any partition. (For 
a partition to use this additional main storage a SET 
command must be entered.) IPL must be performed again 
to activate spooling. Once spooling is activated, it cannot 
be canceled. 


RORQ (RQ): This operand specifies the queue that contains 
the job to which the cancel applies. The jobname operand 
specifies the job that is canceled from the reader queue. 

The RDRO operand is valid only on systems that support 
input spooling. 


PRTQ (WQ): This operand specifies the queue that contains 
the job or job step to which the cancel applies. When the 
jobname operand is used, all steps of the specified job are 
canceled from the print queue. When both the jobname 

and stepname are used, only the specified step is can- 

celed. If the job or step you want to cancel is currently 
being printed, it is terminated immediately; and the next 
step on the queue is processed. 


PCHQ (PQ): This operand specifies the queue that con- 
tains the job or job step to which the cancel applies. When 
the jobname operand is used, all steps of the specified job 
are canceled from the punch queue. When both the job- 
name and stepname are used, only the specified step is 
canceled. If the job or step you want to cancel is currently 
being punched, it is terminated immediately ; and the next 
step on the queue is processed. The PCHQ operand is valid 
only on systems that support punch spooling. 


*RDRQ (*RQ): This operand cancels the entire reader 
queue but does not affect the job currently executing or 
the job currently being placed on the reader queue. The 
“RDRO operand is valid Only on systems that support 
input spooling. 


*PRTQ (*WQ): This operand cancels the entire print queue 
but does not affect the job step currently being printed or 
the output being placed on the queue by an executing 
program. 


*PCHO (*PQ): This operand cancels the entire punch queue 
but does not affect the job step currently being punched 

or the output being placed on the queue by an executing 
program. The *PCHO operand is valid only on systems 

that support punch spooling. 


P1, P2, or P3: This operand cancels the program currently 
executing in the specified partition (1, 2, or 3). The option- 
al 2 operand causes a controlled cancel to be taken; in this 
case files in the program are closed. The optional 3 operand 
Causes an immediate cancel. {f neither a 2 or 3 is specified, 
2 is assumed. The P1, P2, or P3 operand can be used 
whether or not spooling is supported by the system. P3 is 
supported by 5704-SC2 only. 


jobname: This operand specifies the job to which the cancel 
applies. 


stepname: This operand specifies the job step to which the 
cancel applies. 


characters ** (5704-SC2 only): This operand specifies the 
jobs and/or job steps to which the cancel applies. Multiple 
jobs/steps can be referenced by specifying one to seven 
characters followed by two asterisks (**). All jobs/steps 
on the queue whose names begin with the specified 
characters will be canceled. 


Considerations 


A job executing in a partition cannot be canceled by 
specifying its name. It can be canceled only by specifying 
the partition in which it is executing. 


Consider the following example: 
CANCEL PRTQ,JOBA,STEP1 
or 


CN WQ,JOBA,STEP1 


STEP1 of JOBA on the print queue is removed from the 
queue. 
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CHANGE CARD TYPE 
Function 


Changes the card type characters associated with one or more 
jobs or job steps on the punch queue. This command is valid 
only if spooling is active. 


Format 


Operation Operand 


PCHQ jobname 
CHANGE CRD,card , St Pte 
(G) mare ALES [ = ] eas [ 


Contents 


CRD: This operand indicates a change in the card type 
characters for a job or job step on the punch queue. 


card type: This operand may be any combination of one 
to three characters (except commas or blanks) to indicate 
the card type used. These characters are examined by the 
punch writer when punching spooled output. If the card 
type differs from that of the previous punch step, the 
system issues a message to the operator indicating the 
card type to be used. 


PCHOQ: This operand specifies the queue that contains the 
job to which the change in the card type applies. Since 
only the punch queue is valid for this function, the queue 
operand can be omitted as shown in the following example: 


CHANGE CRD,ABC,,JOB1,STEP1 


jobname: This operand specifies the job to which the change 
of card type applies. 


Sstepname: This operand specifies the job step to which the 
change of card type applies. 


characters** (5704-SC2 only): This operand specifies the 
jobs and/or job steps to which the change of card type 
applies. Multiple jobs/steps can be referenced by specifying 
one to seven characters followed by two asterisks (**). All 
jobs/steps on the queue whose names begin with the 
characters specified will have the card type changed. 
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stepname 
,characters* * 


Considerations 


Unless the CHANGE card type command specifies stepname, 
all job steps within a job on the punch queue receive the 
change. 


The CHANGE card type command does not affect a punch 
step that is currently punching. 


CHANGE COPIES 


Function 
Changes the number of output cupies produced by one or 


more jobs on an output queue. This command is valid only 
if spooling is active. 


Format 


Operation Operand 


( PRTQ 

(WQ) jobname 
eer CPY, [number | ‘ 9 pcHO ee 
(G) (PQ) 

Contents 


CPY: This operand indicates a change in the number of 
copies produced by a job on the output quetie. 


number: This operand specifies the number (1-99) of out- 
put copies to be produced by the job or job step. If the 
number of copies is altered while the job step ts being 
punched or printed, the total nuniber of copies produced 
will be the sum of the new number and the number of 
copies already completed. A default value of one copy is 
assumed if the operand ts riot specified. 


PRTQ or PCHQ: This operand specities the queue that 
contains the job or job step to which the change in the 
number of copies applies. 


fobname: This operand specifies the job to which the 
change in the number of copies applies. 


stepname: This operand specifies the job step to which the 
change in the number of copids applies. 


characters** (5704-SC2 only): Tisis operand specities the 
jobs and/or job steps to which the change in the number of 
copies applies. Multiple jobs/steps can be referenced by 
specifying one to seven characters followed by two asterisks 
(**). All jobs/steps on the queue whose narnes begin with 
the specified characters will have the number of copies 
changed. 


,stepname 
,characters** 


Considerations 


Unless the CHANGE copies command specifies stepname, 
all job steps within a job on the output queue receive 


the change. 


CHANGE Copies 


5-5 


CHANGE CORE 


Function 


Changes the amount of main storage required for one or 
more jobs on the reader queue. This command is valid only 
if spooling is active. 


Format 


Operation Operand 


; RDRO jobname 
are CORE size, Ee | , oe 


Contents 


CORE: This operand indicates that a job on the reader 
queue is to have its main storage size requirements changed. 


size: This operand specifies the amount of main storage 
required to execute the largest step in the job. (It does not 
assign main storage to the partition; the SET command 
must be used for this purpose.) The number specified 

(1-3 digits) can range from 0 to 238 (for 5704-SC1) or 
from 0 to 488 (for 5704-SC2). If Ois specified, the 
current partition size is assumed. 


RDRQ: This operand specifies the queue that contains the 
job to which the change applies. Since only the reader queue 
is valid for this command, this operand can be omitted as 
shown in the following example: 


CHANGE CORE,8,,SAMPLE 


jobname: This operand specifies the job to which the 
change of main storage size applies. 


characters** (5704-SC2 only): This operand specifies the 
jobs to which the change of main storage size applies. 
Multiple jobs can be referenced by specifying one to seven 
characters followed by two asterisks (**). All jobs on the 
queue whose names begin with the specified characters 
will have the storage requirement changed. 
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Considerations 


You cannot specify stepname to change main storage 
requirements; jobs on the reader queue can be controlled 
only on a job basis. If the JOB statement for the job to be 
changed is in error, the change is not allowed. 


CHANGE FORMS TYPE 
Function 


Changes the forms type characters associated with one or 
more jobs or job steps on the print queue. This command 
is valid only if spooling is active. 


Format 


Operation Operand 


: “PRTQ jobname 
sa FRM, forms type, aa | : Va a 


Contents 


FRM: This operand indicates a change in the forms type 
characters for a job or job step on the print queue. 


forms type: This operand can be any combination of one 
to three characters (except commas or blanks) to indicate 
the forms type used. These characters are examined by the 
print writer when printing spooled output. If the forms 
type for the current print step is different from that of the 
previous print step, the system issues a message to the 
Operator indicating the forms type to be used. The response 
taken to this message determines if separator pages are to 

be printed between print steps. 


PRTQ: This operand specities the queue that contains the 
job to which the change in the forms type applies. Since 
only the print queue is valid for this function, the queue 
operand can be omitted as shown In the following example: 


CHANGE FRM,ABC,,JOB1,STEP1 


jobname. This operand specifies the job to which the 
change of forms type applies 


stepname: This operand specifies the step to which the 
change ot forms type applies. 


characters** (5704-SC2 only): Tnis operand specifies the 
jobs and/or job steps to which the change of forms type 
applies. Multiple jobs/steps can be referenced by specifying 
one to seven characters followed by two asterisks (**). All 
jobs/steps on the queue whose names begin with the 
specified characters will have the forms type changed. 


»stepname | 
,characters* * 

Considerations 

Unless the CHANGE forms type command specifies 
stepname, all job steps within a job on the print queue 


receive the change. 


The CHANGE forms type command does not affect 
a print step that is currently printing. 


CHANGE Forms Type 
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CHANGE PARTITION 
Function 
Changes the partition assignment of one or more jobs on 


the reader queue. This command is valid only is spooling is 
active. 





Format 
Operation § Operand 
1 RDRO jobname 
P —_— 
CHANGE TN, 2 oa | : oo 
(G) 
3 
A 
B 
C 
D 
Contents 


PTN: This operand indicates that the Partition assignment 
for a job on the reader queue is to be changed. 


7 : ae na : 
3 / This operand indicates the partition to which the 
3 job will be assigned for execution: 
4 ~ Partition 1 
B ae 
— Partition 2 
C 28 
D — Partition 3 


— Partition 1 or 2 
Partition 1 or 3 
— Partition 2 or 3 
Partition 1, 2, or 3 


| 


VDOWPWN = 


If A, B, C, or D is used, spool allows a job to be 
executed in whichever of the specified partitions 
next requests a job for execution (see JOB State- 
ment in Chapter 6). 
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RDRQ: This operand specifies the queue to which the 
change applies. Since only the reader queue is valid for 
this command, the queue operand can be omitted as 
shown in the following example: 


CHANGE PTN,2,,SAMPLE 


Jobname: This operand specifies the job to which the 
change of partition assignment applies. 


characters** (5704-SC2 only): This operand specifies the 
jobs to which the change of partition assignment applies. 
Multiple jobs can be referenced by specifying one to seven 
characters followed by two asterisks (**). All jobs on the 
queue whose names begin with the specified characters will 
have the partition changed. 


Considerations 


You cannot specify stepname to change partition; jobs on 
the reader queue can be controlled only on a jobname basis. 
If the JOB statement for the job to be changed is in error, 
the change is not allowed. 


CHANGE PRIORITY 


This command is valid only for systems that support spool 
ing, and only when spooling is active. 


Functions 


@ Changes the priority of one or more jobs on the reader 
queue. 


@ Changes the priority of one or more jobs or job steps on 
the print or punch queue. 


,characters 


ee 


Format 
Operation Operand 
CHANGE RDRQ, ee ..| 
(G) (RQ) characters 
1 
2 PRTO eens )stepname 1 
ety. /3\ \ (wa) ’ (characters*"f | 
(Y) /4 : 
5 PCHO ee ,stepname | 
(PQ) ’ (characters** characters” * 
Contents 


PTY (Y): This operand indicates that the priority of a job 
or job step on one of the queues is to be changed. 


1,2, 3,4, or &: This operand is the number of the priority 
to be assigned to the job or step. The highest priority is 5. 


RDRQ (RQ): This operand indicates that the reader queue 
contains the job for which the priority is to be changed. 
The jobname parameter identifies the specific job. {f the 
priority of a job on the reader queue is changed, the output 
from that job has the changed priority assigned to it, unless 
the job steps within that job contain the PRIORITY 
parameter on a PRINTER or PUNCH statement. 


PRTQ (WQ): This operand indicates that the print queue 
contains the job or step for which the priority is to be 
changed. When only the jobname parameter is used, the 
priority of all steps in the job is changed to the same value. 
When both jobname and stepname parameters are used, 
the priority of only the specified step is changed. 


PCHO (PQ): This operand indicates that the punch queue 
contains the job or step for which the priority is to be 
changed. When only the jobmame parameter is used, the 
priority of all steps in the job is changed to the same 
vaiue. When both jobname and stepname parameters are 
used, the priority of only the specified step is changed. 


jobname. This operand specifies the job to which the change 
of priority applies. 


stepname: This operand specifies the job step to which the 
change of priority applies. 


characters** (5704-SC2 only): This operand specifies the 
jobs and/or job steps to which the change of priority applies. 
Multiple jobs/steps can be referenced by specifying one to 
seven characters followed by two asterisks (**). All jobs/steps 
on the queue whose names begin with the specified characters 
will have the priority changed. 
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Considerations 


All jobs or job steps are removed from the queue ona 
first-in, first-out basis within Priority. When the priority 
is changed, the job or step is removed from the queue only 
after ail other jobs (or steps) with the same priority have 
been removed. 


Consider the following example: 


CHANGE PTY,5,RDRO,JOBA 
or 
G Y,5,RO,JOBA 


Assuming the priority of JOBA was 1, it is changed to 5 
and scheduled for execution after all preceding priority 5 
jobs have been executed. Output on the print or punch 
queues for JOBA is also changed from 1 to 5, unless the 
job steps within JOBA contain the PR IORITY parameter 
on a PRINTER or PUNCH statement. 
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DISPLAY SCP 5704-SC2 


Line 
Functions 

@ Displays system status information. SYSTEM STATUS DISPLAY 1 
SYSTEM REL nn mm/dd/yy hh:mm:ss 2 
: 3 
@ Displays the history of the entire system. | TASK PRIORITY-(xx, xx, XX=XX) SHA-x 4 
SHARE AREA-nnk - 

; . MAX PROG SI2E-nnnk 
© Displays the history of one to seven tasks (5704-SC2 only). Le ALTA 7 
SPOOL STATUS DISPLAY 8 
en he de intsand:punchqueues. RDR - ddddd/status UNIT-uuu,CYL-nnn 9 
Displays the reader, print, and p SUEHES PRT - ddddd/status TKGP SIZE - nn/aaaa 10 
PCH - ddddd/status TKGPS AVAIL -- nnnn 11 





Format 


Operation Operand The information displayed for SCP 5704-SC1 is described 


in Figure 5-1; information for SCP 5704-SC2 is in Figure 


oe STATUS ee 5-2. The spool status display information (lines 8-11) is 
3 identical for both program numbers and is described only 
' in Fi 5-1. 
'N in Figure 
ee [task ] ae SCP 5704-SC2 displays the status of each partition and 
ue the names of all main data areas and simulation areas 
RO separately. To move forward through the status display 
2 Z sequence (system, partition 1, partition 2, partition 3, 
ui names, system ...), press ENTER in response to each dis- 
(wa) play; or, to skip forward or backward to a specific display, 
PCHO key the partition number (1, 2, or 3), S (for system), or 
(PQ) N (for names) over the cursor and press ENTER. The 
partition status is displayed as follows: 
Contents 


Line 


STATUS: When this operand is specified (or if no operand 





is specified), the status of the system is displayed on the SYSTEM STATUS DISPLAY 1 
CRT as follows: PARTn-nnnk h-— p mm/dd/yy 2 
jobname stepname FL - ddd 3 
RDR - ddddd (SPOOL) R14 - ddd -SWITCH- 4 
SCP 5704-SC1 : PRT - ddddd (SPOOL) F2 - ddd nnnnnnnn 5 
Line ddddd (SPOOL) kR2 - ddd 6 
7 
SPOOL STATUS DISPLAY 8 
ddddd/status UNTT-uuu,CYL-nnn 9 
SYSTEM STATUS DISPLAY (P1,P2,SP) 1 ddddd/status TKGP SIZE - nn/aaaa 10 
PARTL-nnnk,R1 PART2-nnnk 2 ddddd/status TKGPS AVAIL -~- nnnn 11 
jJobname stepname jobname stepname 3 
RDR - ddcddd (SPOOL) RDR - ddddd (SPOOL) 4 
PRE - ddddd (SPOOi) PRP - cdddd (SPOOL) 5 
PCH - ddddad (SPOOL) PCH -— dddde (SPOOL) 6 
nnnKk AVALLABLE min/dd/yy hh:mm:ss 7 aie . . . . A 
SPOOL. SaNPUS DISPLAY 8 The partition status display is described in Figure 5-3. 
RDR - ddddd/status UNTT-uuu, CY L-nnn 9 
PRT - ddddd/status  ‘TKGP SIZE - nn/aaaa 10 : 
BCP a cekigd/ata bas LED GU AUAT Ree Aon 1 To cancel the system status display for 5704-SC1, press 


ENTER. To cancel the 5704-SC2 system status displays, 
key a C over the cursor and press ENTER. 





P1, P2, P3, or N: (5704-SC2 only) This operand specifies 
the first status to display and bypasses the system status 
display. 
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Characters Displayed Meaning 









Cancel; if ENTER is pressed, display is canceled. 





Cc 









SYSTEM STATUS DISPLAY Identifies information in upper half of display. 









(Xx,Xx,xx) Task priority, listed in descending order; for example, P1,P2,SP. 










PART1-nnnK 
PART2-nnnK 


Size of partitions 1 and 2. 







RI 





Partition has been rolled out: a rollin is pending. 









jobname stepname Identity of jobs running in partitions 1 and 2. 















RDR — ddddd 
5 PRT — ddddd 
6 PCH — ddddd 


Reader, printer, and punch devices assigned to each partition by system 
generation, OCL statements, or OCC commands. 










(SPOOL) Displayed if a device is assigned to spooling. 





nnnK AVAILABLE 





Main storage not assigned to partition 1 or 2. 
















dd/mm/yy or 
mm/dd/yy 


SPOOL STATUS DISPLAY 


System date, in format specified during system generation. 














Identifies information in lower half of display. Lines 8-11 are blank 
if spooling is not supported by the system. 














RDR — ddddd 
PRT — ddddd 
PCH — ddddd 


Reader, printer, and punch devices assigned to spooling during system 
generation. 










/status Status of the spool queues: 
ACT — Queue contains jobs or steps to process. 
EMP — Queue is empty. 


H — Queue is held via the HOLD command. 











UNIT-uuu Unit containing the disk space used by spool. 






CYL-nnn 





Number of cylinders assigned to the spool area during system 
generation or IPL. 











TKGP SIZE — nn/aaaa Track group information: 
nn =— Number of tracks per group (1, 2, 4, 5, 10) 


aaaa — Total number of track groups within the spool disk space 










TKGPS AVAIL — nnnn Number of track groups currently available. 






Figure 5-1. Explanation of System Status Display (5704-SC1) 


Line | Characters Displayed Meaning 









1 | SYSTEM STATUS DISPLAY Identifies information in upper half of display. 

2 | SYSTEM REL nn | Release level of the system program. 
mm/dd/yy or dd/mm/yy |System date, in format specified during system generation. 
himenies |Time, in hours, minutes, and seconds. 

4 i TASK PRIORITY- ‘Task priority, listed in descending order; for example, SP,P3,P2,P1, 
| Ox, 206,xx= xx) ‘where SP is the highest priority and P1 is the lowest. Where equal 


| priority has been specified in the PTY command, equal signs (=) appear 
instead of commas. 





SHA-x : System history area status: halt (H)/nohait (N)/CCP auto (C) 
5 SHARE AREA-nnnk ‘Size of the file share area assigned to the system. 
6 | MAX PROG SIZE-nnk | Maximum size program that can be run in a partition. 
7 ink AVAILABLE 2 Main storage not assigned to a partition or file share area. 
8-11 | SPOOL STATUS DISPLAY... | See Figure 5-1. 





Characters Displayed Meaning 


SYSTEM STATUS DISPLAY | Identifies information in upper half of display. 
PARTn-nnnk : Partition number and size. 

h | Halt (H)/nohalt (N) status. 

p Partition stopped via OCC (P). 

mm/dd/yy or dd/mm/yy System date, in format specified during system generation. 


hh:mm:ss i Time, in hours, minutes, and seconds. 


|jobname stepname | Identity of job running in this partition. 


| 
[F1 - ddd | Simulation areas assigned as F1, R1, F2, and R2 for this partition. 
R1 - ddd | 

F2 - ddd 


R2 - ddd 


RDR - ddddd | Reader, printer, and punch devices assigned to this partition. 
PRT - ddddd 
PCH - ddddd 


(SPOOL) | Displayed if the reader, printer, or punch device is assigned to spooling. 
| (SPOOL) 
i (SPOOL) 


t 

| ee d 

| -SWITCH- ‘External indicator switch status. 
| nnnnnnnn 








SPOOL STATUS DISPLAY... See Figure 5-1. 


Figure 5-3. Explanation of Partition Status Display (5704-SC2) 
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HISTORY {(H): This operand displays the contents of the 
“ystam history area. The display is on 11 lines of the 
screen with lines 2 through 11 used for the actual display. 






SYSTEM HISTORY DISPLAY 








| 
Gdisvlay line 2 
i 4isvlay line 3 


i 
} 
i 


{ display line 41 





DISPLAY REQUEST MSG NOT RSP mm 






Mote. he top line controls the direction of the display. 
F Forward 
fs B Backward 


i 

| Cc Cancel the display 

i 
nn eppties to the F and B functions and specifies how many 
lines to roll each time the ENTER key is pressed. nn can 
range trom 17 to 99, 


task (5704-SC2 only): One to seven of the following operands 
specify that the history of a single task or of a combination of 
tasks is to be displayed: 


Task Operand Displays 


Pi History of partition 1 

P2 History of partition 2 

P3 History of partition 3 

Ss System messages 

SP Spool messages 

OCC Operator control commands 

CccP History of all CCP tasks 

CCU History of all CCP user tasks (group 1 
below) 

ccs History of all CCP system tasks (group 2 
below) 

Cxx History of one or more of these 


individual CCP tasks: 
Group 1 


C44 C99 CVV 
C55 CEE CWW 
C66 CGG = CXX 
C77 CHH CYY 
C88 CUU —CZZ2 


Group 2 


CCC (communication manager) 
CDD (display format facility -DFF) 
CMM (communication scheduler) 
CPP (command processor) 

CTT (termination task) 


The task operands are separated by commas, as in the 
following examples: 


DISPLAY HISTORY,P1,P2,S,SP,0CC,CCU,CDD 
or 
D H,S,SP,CCP 


When task operands are specified, the history of the tasks is 
displayed as follows: 


fnn SHA~task1,task2,task3,... 


display line 2 


display line 3 


display line 11 


ENTER DISPLAY REQUEST MSG NOT RSP mm 





RDRO (RQ): This operand is used to display information 
about the reader queue (see Considerations). 


PRTQ (WQ): This operand is used to display information 
about the print queue (see Considerations). 


PCHQ (PQ): This operand is used to display information 
about the punch queue (see Considerations). 


Considerations 


Queue Display Format 


The format of the display is: 
Inn agg QUEUE (h) 


display line 2 
display line 3 


display line 11 


ENTER DISPLAY REQUEST MSG NOT RSP mm 





You use line 1 to control scrolling of the display. To 
change the display, key the control codes into the appro- 
priate positions, then press the ENTER key. 


The meanings of the pgsitions in line 1 are: 


f Enter F to roll the queue display, enter C to cancel 


the display. If neither F or C is entered, F is assumed. 


nn Specifies the number of new lines to be added to the 
next display when the ENTER key is pressed. 


qqq__Indicates which queue is being displayed. 
(h) 1s H when the queue is currently being held. A queue 


is held by specifying it in the HOLD command. Lines 
2 through 11 display the contents of the queue. 





{f, after displaying the contents of one queue, you want 

to display the contents of another, you can do so without 
entering another DISPLAY command. Enter the operand 
(RDRQ, RO, PRTQ, WQ, PCHQ, or PQ) for the next queue 
you want to display in the first two or four positions of 
line 1 and press the ENTER key. 


Reader Queue Display 


The following is an example of a reader queue display con- 
taining the jobname, stepname, position on the queue, 
priority number, the amount of storage required, and the 
Partition in which the job will be executed. The storage 
required is displayed only if it was specified on the JOB 
OCL statement or through the CHANGE command. 


For 5704-SC2, jobs placed on the reader queue by 
$QCOPY under CCP will have the terminal name displayed 
in the stepname position. 


FLO RDR QUEUE (H) POS PR CORE PT 


~--PRIORITY LIMIT 3--- 
FIRST A5 10K 1 
JOB-E 5 1 
JOB-F HQ4 3K 2 
JOB~J H4 2 
3 
2 
1 
3 


JOB-L TERMOL H3 
JOB-I TERMO2 KA2 
JOB-M KL 
ACCOUNTS 4 136K 
END OF QUEUE 


ENTER DISPLAY REQUEST MSG NOT RSP O1 


N 


An (H) on the first line of the display indicates that the 
entire reader queue is held via the HOLD command. 


For 5704-SC2, if the priority limit for jobs placed on the 
reader queue by $QCOPY under CCP is less than five, the 
limit is displayed on the second tine of the display. 


One or two of the following characters can precede the 
priority number in the display: 


A — Indicates that the job is currently executing in the 
partition shown in the PT column (5704-SC2 only) 

H — Indicates that the job is being held via the HOLD 
command 

K — Indicates that the job is in a keep state via the KEEP 
command (5704-SC2 only) 

Q — Indicates that the job is being copied by SQCOPY 
5704-SC2 only) 


For 5704-SC2, an N following the partition number indicates 
that QCOPY-NO was specified on the JOB OCL statement. 
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Print Queue Display 


The following is an example of a display of the print queue 
containing the jobname, stepname, position on the queue, 
job priority, forms type, the number of copies to be 
Printed, and the number of Pages within each copy. 


An (H) on the first line of the display indicates that the 
entire print queue is held via the HOLD command. 


One or two of the following characters can precede the 
priority number in the display: 


A — Indicates that the job step is currently being printed 

H ~ Indicates that the job or job step is being heid via 
the HOLD command 

K — Indicates that the job or job step is in a keep state 
via the KEEP command (5704-SC2 only) 

Q — Indicates that the job or job step is being copied 
by $QCOPY (5704-SC2 only) 

R — Indicates that the job step was Partially canceled 
with a REUSE command and is no longer being 
printed (5704-SC2 only) 


For 5704-SC2, an N after the number of copies indicates 
that QCOPY-NO was specified on a PRINTER OCL 
statement. 


An asterisk (*) after the number of copies indicates that 
the job step is currently executing and that a PRINTER 
statement with DEFER-NO was specified for the job step. 
(A job step that is executing without DEFER-NO specified 
is not displayed.) 


The active forms type will be displayed in the message 
nnn IS ACTIVE FORMS TYPE 
if the print writer was started using a forms type. 


FLO PRT QUEUE (H) Pas 
—--~BCD IS ACTIVE FORMS 
PRINT 1 
PUNCH 2 
ACCOUNTS DUE S BCD 
4 
> 


JOB-E 


PAYABLE 

CHECKS CKS 

REGISTER 6 LKQBCD 

YTDMASTR v L BCD 
END OF QUEUE 


BCD 
PAYROLL 


+ 


Be ho pa oO 


ENTER DISPLAY REQUEST MSG NOT RSP On 
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Punch Queue Display 


The following is an example of a punch queue display con- 
taining the jobname, stepname, position on the queue, 
priority, card type, the number of copies to be punched, 
and the number of cards within each copy. 


An (H) on the first line of the display indicates that the 
entire punch queue is held via the HOLD command. 


One or two of the following characters can precede the 
priority number in the display: 


A — Indicates that the job step is currently being 
punched 

H — Indicates that the job or job step is being held via 
the HOLD command 

K — Indicates that the job or job step is ina keep state 


via the KEEP command (5704-SC2 only) 

Q ~ Indicates that the job or job step is being copied 
by $QCOPY (5704-SC2 only) 

R — Indicates that the job step was partially canceled 
with a REUSE command and is no longer being 
punched (5704-SC2 only) 


For 5704-SC2, an N after the number of copies indicates that 
OQCOPY-NO was specified on a PUNCH OCL statement. 


An asterisk (*) after the number of copies indicates that the 
job step is currently executing and that a PUNCH statement 
with DEFER-NO was specified for the job step. (A job step 
that is executing without DEFER-NO specified is not 
displayed.) 
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JOB-D STEP-2 4 H5 BCD 3 54 
JOB-é PUNCH > HS BCD 4 53 
JOB--F PUNCH 6 KA4 BCD J 50 
PAYROLL CHECKS 7 R3 CKS 7 198 
ACCOUNTS YTDMASTR 8 1 BCD 4N 27 
PAYABLE 9 1 BCD 41 33 
TIMECARD PLANT 10 QL PLT 4 Th 
LAB 41 KL LBT 4, 3 
SUMMARY 12 1 BCD 2* 82 
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HIPTY 

This command is valid only for 5704-SC2 systems that 
support spooled reading and only when spooling is active. 
Function 

Limits the priority of jobs placed on the active spool file 


reader queue by $OCOPY (spool file copy program) under 
CCP. 


Format 

Operation Operand 
HIPTY high-priority 
(HP) 

Contents 


high-priority: This operand can be any value from O through 
5; it specifies the high-priority limit of jobs placed on the 
active spool file reacler queue by SOCOPY under CCP. For 
example, if you specify 3 as the high-priority operand, the 
highest priority allowed for jobs placed in the reader queue 
by $QCOPY under CCP is 3. If you specify 0, the priority 

is limited to 1 and held. 


Considerations 


A job with a JOB statement error will be placed on the queue 
with priority 5, regardless of the HIPTY limit. 


A job being placed on the queue at the time the HIPTY 
command is entered will not be affected by the limit 
specified. 


The limit specified remains in effect until another HIPTY 
command is entered or until an IPL is performed. After an 
IPL, the limit in effect is 5 unless otherwise specified by 
SCNFIG. 
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HOLD 


This command is valid only for systems that support spool- 
ing, and only when spooling is active. 


Functions 


@ Prevents one or more jobs from being executed from the 
reader queue. 


e Prevents one or more jobs or job steps from being printed 
from the print queue. 


e@ Prevents one or more jobs or job steps from being 
punched from the punch queue. 


@ Prevents all jobs from being executed, printed, or 
punched from the specified queues. 


Format 
Operation Operand 
HOLD RDRO aoe . \ 
(H) (RQ) ,;characters 
,Jobname ,Stepname 
PRTQ 
(wa) ak [crmncons] 
obname ,stepname 
PCHQ f “a [ ss] 
(PQ) ,characters ,characters 
Contents 


RDROQ (RQ): This operand prevents the execution of any 
job from the reader queue; however, jobs can continue to 
be placed in the reader queue. Using the optional jobname 
parameter, only a particular job is held. 


PRTQ (WQ): This operand prevents any output from be- 
ing removed from the print queue; however, output from 
executing jobs or steps can continue to be placed in the 
print queue. Using the optional jobname parameter, all 
steps of the specified job are held. Using the jobname and 
stepname parameters, only a particular step is held. 


PCHOQ (PQ): This operand prevents any output from being 
removed from the punch queue; however, output from ex- 
ecuting jobs or steps can continue to be placed in the 
punch queue. Using the optional jobname parameter, all 
steps of the specified job are held. Using the jobname and 
stepname parameters, only a particular step is held. 
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jobname: This operand specifies the job to be held. 
stepname. This operand specifies the job step to be held. 


characters ** (5704-SC2 only): This operand specifies the jobs 
and/or steps to be held. Multiple jobs/steps can be referenced 
by specifying one to seven characters followed by two 
asterisks (*). All jobs/steps on the queue whose names 

begin with the specified characters will be held. 


Considerations 


The job or job step is held on the queue until released by 
a RELEASE command or canceled by a CANCEL com- 
mand. If the entire queue is held, it remains held until 
released by a RELEASE command. 


Holding a job on the reader queue has the same effect as 
specifying PRIORITY-O on the JOB statement. The 
RELEASE command is required to remove a job from the 
hold state. 


When a job that is still executing is held by jobname on 
the print or punch queue, only those steps of the job that 
are on the queue at the time of the HOLD command are 
held. Subsequent steps of the job placed on the queue are 
not held. 


When used to hold jobs or steps, the HOLD command 
takes effect immediately. When used to hold an entire 
queue, the command does not take effect immediately. 
Consider the following examples: 


1. HOLD PRTO,JOBA 
or 
H WQ,JOBA 


If this command is entered while JOBA is being 
printed, the writer immediately terminates printing 
JOBA and continues with the next job on the 
queue. When JOBA is released, it is printed from 
the beginning, or from the beginning of the inter- 
rupted copy if multiple copies were requested. 
(This action also occurs for holding steps, as well as 
jobs, on the print and punch queues.) 


2. HOLD PRTQ 
or 
H WO 


When the entire queue is held, the step currently 
printing is completed before the queue is held. If 
multiple copies are requested, the queue is held 
when the current copy is complete. When the queue 
is released, Printing begins with the next copy. 


KEEP 


This command is valid only for 5704-SC2 systems that 
support spooling and only when spooling is active. 


Function 


Causes one or more jobs or job steps to be placed back on the 
queue in the hold state after they have been printed, 
punched, or executed. 


Format 

Operation Operand 

KEEP RDRQ, eon | 

(KP) (RQ) characters” * 
PRTQ, { jobname ,stepname 
(WQ) characters* * ,characters” * 
PCHQ, vaptile \ sstepname 
(PQ) characters* * ,characters” * 

Contents 


RDRO, PRTQ, or PCHQ: This operand specifies the queue 
that contains the job or job step to be kept. 


jobname: This operand specifies the job to be kept. 
stepname: This operand specifies the job step to be kept. 


characters ** (5704-SC2 only): This operand specifies the 
jobs and/or job steps to be kept. Multiple jobs/steps can 

be referenced by specifying one to seven characters followed 
by two asterisks (**). All jobs/steps on the queue whose 
names begin with the specified characters will be kept. 


Considerations 


The KEEP command cannot be used unless the job cr job step 
is on the queue. The job or job step is kept in the queue until 
it prints, punches, executes, is released by a RELEASE 
command, or is canceled by a CANCEL command 
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PTY 


Function 


Changes the priority of the following tasks in the system 
control program: 


Spooling (reader, print writer, punch writer) 
Partition 1 
Partition 2 
Partition 3 


The priority of these tasks determines the order in which 
they receive the services of the system control program. 
The spooling task refers to the spooled reader and/or writer. 
The PTY command can be entered at any time. 


At IPL, the priority of these tasks is SPOOL, P3, P2, P1, 
with SPOOL having the highest priority. If SPOOL is not 
used, the priority is P3, P2, P1, with P3 having priority 
over P2 and P1. If SPOOL is not used and P3 is not sup- 
ported (5704-SC1), the priority is P2, P1, with P2 having 
priority over P1, 


Format 

Operation Operand 

PTY ‘ SPOOL > 

(Y) \ (se) | 
“Pq Petia. 
)e2 1={ 
\P3 

Contents 


SPOOL: This operand specifies the spooling task for a 
Priority change. 


P1, P2, or P3: These Operands specify the partition to 
which the priority change applies. 


Considerations 


The order of the operand indicates the requested priority: 
the leftmost operand has the highest priority; the rightmost 
operand the lowest. Two or more tasks can be given equal 
Priority by specifying an equal sign (=) or dash (-) instead 
of a comma (,) between the operands (5704-SC2 only). 
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The following rules apply to the operands on the PTY 
command: 


1. Each operand can be specified only once. 


2: SPOOL is an invalid operand if spooling is not sup- 
ported or is canceled. 


3. All operands must be specified; there are no defaults. 
The following examples illustrate the first three rules: 


P1,P2,P3,SP 
P1,P2,P3 
P1=P2=P3 
P1-P2-P3 
SP,P2,P1 
P1,P2 


4. Only one group of operands may be equated. For 
example: 


SP=P3,P2=P1 
is not valid, but 

SP=P3=P2=P1 and SP,P3=P2=P] 
are valid. 

5. The task that contains the communications control 
program (CCP) cannot be given equal priority with 
another task. For example: 

P3=SP,P2,P1 
is not valid if CCP is executing in P3, but 


P3,SP=P1=P2 


is valid. 
To improve the throughput of nonspooling tasks, the 
priority of the spooling tasks can be lowered if: 
@ The spooled output (print or punch) is of low volume. 


@ Turnaround time is not important. 


Changing the priority can increase the performance of one 
task at the expense of another task. 


For example, to cause the spooling task to have a lower 
Priority in the system control program than P1 or P2, but 
higher than P3, the following command can be entered: 


PTY P2,P1,SPOOL,P3 
or 
Y P2,P1,SP,P3 


READER 
Function 


Changes the system input device for a partition. 


Format 

Operation Operand 

READER Pl 

(RDR) P2 | , device 
P3 

Contents 


P1, P2, or P3: This operand specifies the partition for which 
the system input device is to be changed. If the partition 

is not specified, P1 is assumed. The device parameter can 

be one of the following: 

@ MFCU1 — Primary hopper of the 5424 

@ MFCU2 — Secondary hopper of the 5424 

@ MFCM1 — Primary hopper of the 2560 

@ MFCM2 — Secondary hopper of the 2560 


@ 3741 — 3741 Data Station or Programmable Work Station 
(directly attached) 


@ 1442 — 1442 Card Read Punch 
@ 2501 — 2501 Card Reader 


@ CONSOLE — 3277 Display Station (CRT/Keyboard) 


Considerations 


When this command is entered, the specified partition must 
be at end of job and it must not have a system input 

device allocated to it at this time. The device assigned 
remains as the system input device until (1) changed by 
another READER command, (2) changed by a READER 
OCL statement, or (3) an IPL is performed. 


The system input device for a spooled job stream can be 
changed; however, if the new system input device is differ- 
ent from the spooled input device, input spooling stops 
for that partition. Input for the partition comes from the 
new system input device instead of from the spooled input 
job stream. 


To resume input spooling, the system input device must 
be changed back to the system input device that is accept- 
ing spooled input. 
Consider the following example: 

READER P1,MFCU1 


or 
RDR P1,MFCU1 


The primary hopper of the MFCU is assigned as the sys- 
tem input device for partition 1. 


READER _ 5-21 


RELEASE 


This command is valid only for systems that support spool- 
ing, and only when spooling is active. 


Functions 


® Releases a queue or one or more jobs or job steps that 
were held by the HOLD command. 


@ Releases one or more jobs that were assigned a priority of 
0 on the JOB statement. 


@ Releases one or more job steps that were assigned a 
priority of 0 on the PRINTER or PUNCH statement. 


Format 
Operation Operand 
RELEASE / RpRa | Jobname 
(R) (RQ) ,;characters 
Jobname ,»stepname 
PRTQ 
(wa) pee : eae |] 
,jobname ,stepname 
PCHQ 
(PQ) eas . oo. .| 
Contents 


RORQ (RQ): This operand releases the reader queue. Any 
jobs on the queue that are in a hold state continue to be 
held. Using the optional! jobname Parameter, a particular 
job is released. The RDRO operand is valid only on sys- 
tems that support input spooling. 


PRTQ (WQ): This operand releases the print queue. Any 
jobs or steps on the queue that are in a hold state continue 
to be held. Using the optional jobname parameter, all steps 
of the specified job are released. Using the jobname and 
stepname parameters, only a particular step is released. 
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PCHQ (PQ): This operand releases the punch queue. Any 
jobs or steps on the queue that are in a hold state continue 
to be held. Using the optional jobname parameter, all steps 
of the specified job are released. Using the jobname and 
stepname parameters, only a particular step is released. 

The PCHO operand is valid only on systems that support 
punch spooling. 


jJobname: This operand specifies the job to be released. 
stepname: This operand specifies the job step to be released. 


characters** (5704-SC2 only): This operand specifies the 
jobs and/or job steps to be released. Multiple jobs/steps can 
be referenced by specifying one to seven characters followed 
by two asterisks (**). All jobs/steps on the queue whose 
names begin with the specified characters will be released. 


Considerations 


A released job or job step that was previously held by a 
HOLD command retains the priority assigned to it. 


A job that was held by jobname is not released by using 
only a RDRQ, PRTQ, or PCHO operand; it must be re- 
leased by jobname. 


A step that was held by jobname and stepname is not re- 
leased by using only a RDRQ, PRTQ, or PCHO operand; 
it must be released by jobname and stepname. 


The RELEASE command does not always void all functions 
of the HOLD command. For example: A job step that 

was being printed or punched is held and then released 
while the writer is waiting or stopped; when the writer 
Starts, it acts as if the job step is still held. The first 
available job step on the queue is printed or punched. 


Consider the following example: 


RELEASE RDRQ 
or 
RRQ 


This command releases the reader queue previously held by 
a HOLD RDRO command. 


RESTART 


This command is valid only for systems that support spoo!- 
ing, and only when spooling is active. 


Functions 


@ If entered while the print or punch writer is active, 
restarts printed or punched output of that job step. 


@ if entered when the writer is not active, causes the 
writer to start with the job step that was stopped, if one 
was stopped, or from the beginning of the queue if no 
job steps were previously stopped. 


Format 
Operation Operand 
RESTART PRT |,PAGE 
(T) (w) |(PG) 
Number 
PCH 
(P) 
Contents 


PRT (W): This operand causes the output of the step 
currently being printed to be restarted. {f an operand is 
not specified for the RESTART command, PRT is assumed. 


PAGE (PG): \f entered when the print writer is active (not 
terminated), this operand causes the print writer to restart 
at the beginning of the current page. If entered when the 
print writer is not active, this operand causes the print writ- 
er to start printing from the beginning of the first page not 
previously finished. This operand will not be accepted after 
page 65535 has been printed. If PAGE is specified when 
starting the print writer after an IPL, the specification is 
ignored and page 1 is started. 


number: This operand specifies the number (1 to 65535) 
of the page to be started. If the number specified is higher 
than any page in the job step, spool issues an error message 
(or waits for the specified page if the job step is still 
executing). 


The page number reflects the pages in the spool queue, not 
necessarily the page numbers on the user report. When a 
step is terminated, the message indicates the page number 
at that time. Also, the display of the print queue shows 
the number of pages for that step in the print queue. 


PCH (P}: This operand causes output from the step cur- 
rently being punched to be restarted from the beginning. 


Considerations 


When the RESTART PRT or RESTART PCH command 

is entered, the printing or punching of the current job step 
is immediately terminated. Depending on the command 
entered, the message PRT RESTART PENDING or PCH 
RESTART PENDING is displayed. The message allows 
the operator to correct any situation that may have caused 
the RESTART to be entered. Response to the message 
initiates the restart. 


A STOP command is not required prior to issuing a 
RESTART command; however, a RESTART command 
can be entered following a STOP command. 


When the print writer is restarted at a specified page, the 
restart may not occur immediately. The length of time 
required to find the page in the spool file varies depending 
on the page number required, the priority of the spool 
print writer in relation to the program partitions, and the 
track group size used in the spool file. 


If the print or punch writer is producing output for a job 
step that is currently executing and a RESTART writer 
command is entered while the writer is waiting for more 
data from the job step, the writer is not restarted until the 
job step produces the required data for the writer or until 
the job step completes. 


You should respond to any |/O error messages before 
entering the RESTART PRT or RESTART PCH command. 
The RESTART command is not executed until you have 
responded to these |/O error messages. 


Consider the following example: 


RESTART 
or 
T 


This command causes the print writer to immediately 
terminate printing the current job step. When the operator 
responds to the message PRT RESTART PENDING, the 
print writer prints output of the job step starting with the 
first page. 
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REUSE 

This command is valid only for 5704-SC2 systems that 
support spooling, and only when spooling is active. 
Function 


Frees space in the spool file from, the currently printing or 


punching job step (before printing or punching is complete), 


making that space available for other uses. 


Format 

Operation Operand 

REUSE PRTQ ‘ob ie 

(RU) (wa) obname[,stepname 
PCHO. b Pee 
(PQ) ,jobname[,stepname 

Contents 


PRTQ or PCHQ: This operand specifies the queue that 
contains the currently printing or punching job step to 
which the reuse applies. 


Jobname: This operand specifies the job to which the 
reuse applies. 


stepname: This operand specifies the job step to which 
the reuse applies. 


Considerations 


The REUSE command is most useful when the SPOOL 
FILE FULL message is issued. The space freed from the 
currently printing or punching job step can be used for any 
spooled input or output from any partition. 
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If spool is stopped after space is freed from a print step or 
if a print writer is stopped and then started with a different 
forms type operand, that print step can be restarted only if 
you enter a RESTART command with the number of a 
page that is still in the queue. To restart, you must: 


1. Stop the print writer. 


2 Move the reused job step to the front of the queue 
{either by changing the priority or by holding other jobs). 


De Enter the RESTART command. 


If spool is stopped after space is freed from a punch step, 
that punch step cannot be restarted. 


When a REUSE command is entered, the number of copies 
for the job step is set to 1 and cannot be changed. Also, a 
HOLD command is not allowed for that job step if the step 
is stili being printed or punched. 


After a REUSE command is entered for a job step, the 
spool file that contains that step can be used only by 
SCP 5704-SC2 (version 2 or later). 


Consider the following example: 


REUSE PRTQ,JOBA 
or 
RU WQ,JOBA 


1f this command is entered while JOBA is being printed, the 
command will be accepted and disk space in the spool file 
will be made available for use by other spooled input or 
output. 


START 
Functions 
® Activates spooling immediately after IPL. 


@ Starts the input spooling routine (reader), print writer, 
or punch writer. 


® Starts spooling in a partition that has had spooling 
stopped by the STOP command. 


Note: The preceding functions are valid only for 
systems that support spooling. 


@ Starts program execution in a partition (5704-SC2 only). 


Format 
Operation Operand 
START SPOOL P14 
° (SP) We 
,P3 
[,NEW] [,unit] [,size] 
[,track group size] 
ROR | ROLL] 
(R) 
PRT (,forms type] 
(W) 
PCH 
(P) 
Pi 
P2 
P3 
Contents 


SPOOL (SP): This operand activates spooling at IPL or 
starts spooling after it was stopped in a partition. If used 
with the NEW, unit, size, and/or track group size parame- 
ters, the SPOOL operand can be entered only at IPL prior 
to initiation of the first job. If any of these values is omit- 
ted, the value specified during system generation is used. 


Once spooling is activated by the START command, spool- 


ing remains active until you enter a STOP command. 


P71, P2, or P3: This optional parameter of the SPOOL 
operand is used to start spooling in a partition in which 
spooling was stopped by a STOP command. The START 
command specifying a partition can be entered only after 
the spooling function has been activated. If the START 
command with the partition parameter is entered at the 
end of a job when the system input device has been released, 
spooling for the partition begins immediately. If it is 
entered during the execution of a job, it takes effect at the 
next end of job (not end of step) that releases the system 
input device. 


NEW. This optional parameter of the SPOOL operand 
causes the spooling area on disk to be reformatted. Pre- 
vious input or output in this area is lost. When NEW is 
specified and data is found in the spool file, the message 
THE SPOOL FILE CONTAINS DATA warns that data will 
be destroyed if a continue option is taken. Options to the 
message allow the operator to continue or cancel the 
START SPOOL,NEW request. If NEW is not specified, 
existing data in the spooling area is not lost. If no data 
exists, the area is reformatted. 


Unit: This optional parameter of the SPOOL operand 
changes the disk unit on which spooled records are written. 
The specified disk unit overrides the unit specified during 
system generation and remains in effect until the next {PL. 

\f the same spool file is to be used after the next IPL, the unit 
parameter must again be specified. See Figure 1-1 for a 

list of possible disk units. 


Size: This optional parameter specifies the size of the 
spooling area, in number of cylinders. The maximum size 
that may be specified is 199 for a 5445, 166 for a 3340 
main data area, and 186 for a 3344 main data area. This 
parameter overrides the value specified during system 
generation only when NEW is specified, and it remains in 
effect until that spooling disk area is reformatted or a new 
area is built on the disk pack. Whenever size is specified, 
NEW must also be specified. 


Track Group Size: This optional parameter of the SPOOL 
operand changes the size of the track groups within the 
spooling disk area. Valid sizes that can be specified at IPL 
are 1,2,4,5, and 10. This parameter overrides the value 
specified during system generation only when NEW is spe- 
cified, and it remains in effect until that spooling disk area 
is reformatted or a new area is built on the disk pack. 
Whenever track group size is specified, NEW must also be 
specified. 
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RDR (R): This operand activates the input spooling routine 
that reads from the spooled reader and places the jobs in 
the reader queue. This operand is used to start the spooled 
reader following IPL or after the reader has been termi- 
nated. Spooling must be active prior to entering a START 
RDR command and the punch writer must not be active. 


ROLL: The optional ROLL parameter atlows cards read 
on the MFCU to be placed in each of the four stackers 
before operator intervention is required. Stopping the 
reader with the STOP RDR command and then restarting 
without the ROLL parameter causes ali the cards read to 
be placed in only one stacker. 


PRT (W): This operand activates the print writer so print- 
ing of spooled records from the print queue can begin 

when the spooled printer is available. The PRT operand 
starts the print writer following IPL or after the print 

writer has been terminated. |f used after a STOP command, 
printing begins at the point at which the writer was termi- 


nated. Spooling must be active prior to entering a START 
PRT command. 


Forms Type: When the forms type operand is supplied, 
the print writer prints only those job steps in which the 
forms type matches that given in the START command. 
For example, START PRT,ABC causes only those job 
steps in which the forms type is ABC to be printed. 


To change the forms type, the print writer must be termin- 
ated (STOP PRT), and a new START command specifying 
different forms type must be entered. 


If the print writer is started without the forms type 
operand, it prints job steps in the order in which they 
occur on the print queue. 


PCH (P): This operand activates the punch writer so punch- 
ing of spooled records from the punch queue may begin 
when the spooled punch device is available. This operand 
starts the punch writer following IPL or after the punch 
writer has been terminated. When used after a STOP com- 
mand, punching begins at the point in which the writer 

was terminated. Spooling must be active prior to entering 

a START PCH command, and the reader must not be 
active. 
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P1, P2, or P3: (5704-SC2 only) These operands are used 
to start program execution in a partition in which execution 
was stopped by a STOP command. The START Px com- 
mand can be entered at any time and takes effect 
immediately. 


Considerations 


If the START SPOOL command is not entered following 
IPL, the system activates spooling according to the speci- 
fications given during system generation. This command 
is valid only on systems that support spooling. 


If START PRT or START PCH is entered while the respec- 
tive writer is active, the START command is ignored. 


Once a disk drive has been specified as the spool unit, the 
disk pack on that drive should not be removed (unless an 
IPL procedure is to be performed) even though all of the 
spooling functions have been terminated. 


Consider the following examples: 


1. START SPOOL,NEW,D1,50,5 
or 
S SP,NEW,D1,50,5 


This command, given at IPL, reformats the spool area 
on disk. Existing data in the spool file is lost. The 
spool data area is built on drive 1, is 50 cylinders in 
size, and has a track group size of 5 tracks. The 
operator will be informed by the display if previous 
data exists in the spool file. 


2. START SPOOL,, D1 
or 
SSP,,D1 


If there is any data in the spool queues, this command, 
given at IPL, does not reformat the spool area on disk; 
the number of cylinders used for spooled data is not 
changed. If there is no data in the spool queues, the 
spool area is reformatted, and the number of cylinders 
and track group size are the values specified during 
system generation. In either case, the disk unit is D1. 


3. START SPOOL,P2 
or 
S SP,P2 


If spooling is stopped in partition 2, this command 
starts spooling in partition 2 after the next end of 
job (not end of step). 


STOP 

Functions 

@ Terminates spooling in a partition. 

@ Terminates the reader, print writer, or punch writer. 


Note: The preceding functions are valid only for sys- 
tems that support spooling. 


@ Stops program execution in a partition (5704-SC2 only). 


Format 
Operation Operand 
TOP ( 
ee spooc {'P"| 
(P) (SP} ,P2 
V'p3f 
RDR 
(R) 
/STEP 
PRT (ES) 
(W) ,PAGE 
(PG) 
PCH | 
(P) (ES) 
P1 
P2 
P3 
Contents 


SPOOL (SP): This operand causes spooling to be termi- 
nated in the specified partition: partition 1 (P1), partition 
2 (P2), or partition 3 (P3). After IPL, the STOP SPOOL 
command can be entered at any time following initiation 
of spooling. The command takes effect at the next end of 
job (not end of job step) when the system input device is 
released. The command takes effect immediately if it is 
entered at end of job. Spooling remains stopped in that 
partition until a START SPOOL command is entered in the 
partition. When spooling has been stopped, jobs execute 
in the same manner as in a system without spool support; 
that is, the jobs use the unit-record devices directly. 


RDR (R): This operand causes the input spooling routine 
(reader) to terminate immediately, releasing the input de- 
vice for other use. The job currently being spooled is not 
put on the reader queue. 


PRT (W): This operand causes the print writer to termi- 
nate, releasing the printer for other use. The job step 
currently being printed is kept on the queue; it can be 
continued from the point of interruption using a START 
PRT command, or the print writer can be started from the 
beginning of any page using a RESTART command. 


The STEP (ES) operand causes the print writer to delay 
termination until the current step or copy is completed 
and removed from the queue. If the print writer is already 
at the end of a step, it ignores this operand and terminates 
immediately. 


The PAGE (PG) operand causes the print writer to delay 
termination until the current page is completed. If the 
print writer is at the end of a print step, it ignores this 
operand and terminates immediately. 


Note: \|f neither the STEP nor the PAGE operand is enter- 
ed, the print writer terminates immediately. 


PCH (P}: This operand causes the punch writer to termi- 
nate, releasing the punch device for other use. The job 

step currently being punched is kept on the queue; it can be 
continued from the point of interruption using a START 
PCH command, or it can be started frorn the beginning 
using a RESTART PCH command. 


The STEP (ES) operand causes the punch writer to delay 
termination until the current step or copy 1s completed and 
removed from the queue. If the punch writer is already at 
the end of a step, it ignores this operand and terminates 
immediately. If this operand is not entered, the punch 
writer terminates immediately. 


P71, P2, or P3: (5704-SC2 only) These operands are used 
to stop program execution !n a partition. This command 
cannot be entered for the partition in which the communi- 
cations control program (CCP) is executing or when a 
partition is using certain system resources, such as the 
system interlocks. This command takes effect immediately. 
A START command is required to resume program execu- 
tion after it has been stopped. 


Note: The STOP Px command can also cause the spool 
writers to stop execution if they are printing or punching 
data from the job step when it is stopped. They will 
resume printing or punching after execution has been 


started in the partition. 
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Considerations 


Once a disk drive has been specified as the spool unit, the 
disk pack on that drive should not be removed (unless an 
IPL procedure is to be performed} even though all of the 
spooling functions have been terminated. 


if the print or punch writer is producing output for a job 
step that is currently executing and a STOP writer com- 
mand is entered while the writer is waiting for more data 
from the job step, the writer is not stopped until the job 
step produces the required data for the writer or until the 
job step completes. 


You should respond to any I/O error messages before enter- 
ing the STOP RDR, STOP PRT, and STOP PCH commanas. 
The STOP command is not executed until you have 
responded to these I/O error messages. 


Consider the following example: 
STOP SPOOL,P1 
or 


PSP,P1 


This command causes spooling to be terminated when 
partition 1 is at end of job (not end of job step). 
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The following Model 15 OCL statements contain informa- 
tion that has special considerations for a spooling 
environment: 


@ ASSIGN 


e JOB 


PRINTER 


PUNCH 


READER 


Chapter 6. OCL Considerations 


ASSIGN 


The ASSIGN statement is supported only by SCP 5704-SC2. 


Function 


Reassigns logical simulation areas (F1, R1, F2, R2) to any 
of the supported physical simulation areas. Each logical 
5444 unit (F1, R1, F2, R2) for a given partition must be 
assigned to a unique physical simulation area. The system 
pack cannot be reassigned; therefore, a maximum of nine 
user-assigned simulation areas is allowed (three per 
partition). Simulation area assignments remain in effect 
until another ASSIGN statement is received or until IPL. 
An ASSIGN statement placed in a job ensures that, no 
matter which partition the job is executed in, the correct 
simulation areas are assigned. 


Placement 
The ASSIGN statement may appear anywhere among the 
OCL statements. In a procedure, it must precede the RUN 
statement (if RUN is used). 
Format 
// ASSIGN F1-physical simulation area 

R1-physical simulation area 

F2-physical simulation area 

R2-physical simulation area 


Example 


// ASSIGN R2-D3E,F2-D2B 
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JOB 


The JOB statement is required when spooling is active. 


Function 


Groups related job steps together to ensure sequential exe- 
cution. (The system does not initiate the next step of a 
job until the previous step has come to a successful com- 
pletion.) 


Placement 

The JOB statement must precede the first LOAD or 
CALL statement for a job. It cannot be used in a proce- 
dure. (Since a job cannot be executed as an inquiry pro- 
gram, the JOB and /. statements are ignored if a rollin 

is pending for that partition.) 


Format 


//jobname JOB parameters 


fobname. This is a required entry used to uniquely identify 


ajob. It must begin in position 3, may not exceed 8 charac- 


ters, and may not contain a comma. Job (and step) names 
should contain only characters that are on the 3277 Dis- 
play Station keyboard; otherwise, that job cannot be ref- 
erenced by its name using OCC. 


The jobname ts displayed on the screen with system 
messages associated with the job. It is also the name by 
which jobs are identified on the queues. 


When jobs are being read onto the reader queue, any errors 
on the JOB statement cause that job to be assigned a prior- 
ity of 5. If the jobname is missing or invalid, the default 

jobname, JOB, is assigned to that job on the reader queue. 
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Contents 


All parameters are optional. They are as follows (defaults 
are underlined): 


e PRIORITY- 


OWN] Oo 


@ PARTITION- 


DODDPwWN|= 


@ CORE-nnn (1 to 3 digits) 


;YES| 


@ SPOOL- INO { 


© acopy. \vEs| 
\No 


PRIORITY: A priority can be assigned to a job to indicate 
its level of importance on the reader or output queues. 

The priority of each step of a job on the output queue is the 
same as the priority of that job on the reader queue, untess 
it is changed with a CHANGE priority command or speci- 
fied separately on a PRINTER or PUNCH statement. 
Priority 0 is the same as priority 1 except that it indicates 
that the job is to remain on the reader queue until released 
by a RELEASE command. Priority 5 is the highest priority 
that can be assigned. Within a given priority, jobs are 
scheduled for execution on a first-in, first-out basis: that 

is, if two Jobs have the same priority, the first one put on 

a queue is the first one removed. If this parameter is not 
specified, priority 1 is assumed. 


PARTITION: This parameter specifies the partition in 
which a job is to be executed. {ff this parameter is not 
specified and input spooling is not used, the system 
assumes that the job can be executed in any partition. 
When input spooling is used, the job is scheduled for 
execution in the specified partition; if the partition is not 
specified, partition 1 is assumed. Specifying a PARTITION 
value of A, B, C, or D indicates the job can be run in any 
of the specified partitions, depending upon which partition 
is available at the time the job is scheduled to be run. The 
following are the partition assignments for the different 
parameters of the PARTITION operand: 


Partition 

Assignment 
PARTITION-1 1 
PARTITION-2 2 
PARTITION-3 3 
PARTITION-A lor 2 
PARTITION-B Tor 3 
PARTITION-C 2or3 
PARTITION-D Tor 2or3 


CORE: This parameter specifies the amount of main stor- 
age required to execute the largest step in a job. It ensures 
an adequate partition size for the duration of that job. 
The CORE parameter does not assign main storage for a 
partition; a SET command must be used for this purpose. 
When this parameter is specified, the partition must have 
the requested amount of main storage available before 

the job can be executed. When this parameter is not 
specified, the system assumes the job is scheduled in a 
partition with adequate main storage and uses the present 
Partition size as the minimum for the job. CORE can be 
any multiple of 2 from 8 to 238 for 5704-SC1, or from 8 
to 488 for 5704-SC2. If it is not a multiple of 2, it is 
rounded up to the next multiple of 2. A number less than 
8 is treated as 8. 


SPOOL: This parameter indicates whether or not spooling 
is to be active for the execution of the job. SPOOL-YES 
specifies that a job can be run with spooling active. If the 
parameter is not given, SPOOL-YES is assumed. 


SPOOL-NO ensures that the job is not loaded if spooling 
is active in that partition. It is the user’s responsibility to 
ensure that I/O devices for the job are available and spool- 
ing has been stopped for the partition. By using the STOP 
OCC command, spooling can be stopped for the partition, 
and the spooled reader, punch, or printer can be stopped. 
SPOOL-NO should be used when a job requires dedicated 
use of one or more devices being used by spooling. 


QCOPY (5704-SC2 only): This parameter specifies whether 
or not the spool file copy program may copy this job from 
the reader queue. QCOPY-NO specifies that the job cannot 
be copied. QCOPY-YES specifies that the job may be copied. 
If the parameter is not specified, QCOPY-YES is assumed. 
Considerations 
When keyword parameters are not specified on this state- 
ment, comments cannot be given following the JOB state- 
ment identifier. 
Consider the following examples: 

//SOBA JOB CORE-8 comment 
is valid. 


//SJOBB JOB comment 


is not valid. 
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PRINTER 


Functions 


® Defines the system print device. 


@ Provides related information for a spooling environment. 


Placement 


The PRINTER statement must precede the RUN statement. 


Format 


// PRINTER parameters 


Contents 
The parameters are as follows: 
1403 


e 2 ky 
DEVICE oat 


@ LINES-nnn 
@ FORMSNO-nnn 


@ COPIES-nn 


e DEFER Ng 


@ PRIORITY- 


afr WH Oo 
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DEVICE: This optional parameter identifies the system 
print device. If it is omitted, 1403 is assumed. The 3284 
printer cannot be spooled. 


LINES: This optional parameter alters the number of print 
lines per page (forms length). The specified value can 
range from 12 to 112. The specified forms length remains 
in effect for that partition until another PRINTER state- 
ment with a LINES parameter is entered or until the next 
IPL. This parameter overrides the forms length specified 
during system generation. The forms length specified in 

a user program overrides the value specified in the LINES 
parameter. The forms length in a user program is in effect 
for the duration of that job step only (at the end of the 
step, the forms length is restored to the previous value). 


FORMSNO: This optional parameter is used to inform the 
Operator when to change forms in the printer and what 
forms to insert. Up to 3 characters can be used in any 
combination; commas, apostrophes, or blanks cannot be 
used. When this parameter is used, the print writer issues 
a message if the forms type for the current print step 

is different from the forms type of the previously printed 
step. The response taken to this message informs the print 
writer if separator pages should be printed between jobs 
and job steps. The parameter is effective only for the step 
in which the PRINTER statement was included. 


COPIES: This optional parameter allows the user to obtain 
from 1 to 99 copies of a job step’s spooled printed output. 
If the parameter is not specified, only one copy is printed. 
When multiple copies are requested, the print writer pro- 
duces the number of requested copies before continuing 

to the next step on the print queue. This parameter is 
effective only for the step in which the PRINTER state- 
ment was included. The COPIES parameter is ignored 
when spooling is not active. 


DEFER: This optional parameter can be used to defer 
the spooled printed output of a step until the step has 
completed execution. DEFER-NO allows the output of a 
step to begin printing before the job step has completed 
execution. DEFER-YES prevents printing until the step 
has completed execution. The DEFER parameter applies 
only to the job step in which the PRINTER statement was 
included. It is ignored when print spooling is not active. 
If the parameter is not specified, DEFER-YES is assumed. 


ALIGN: This optional parameter is used to assist the oper- 
ator with forms alignment. When ALIGN-YES is specified, 
the printer stops after printing the first line, and a message 
is displayed. The response to the message indicates that 
(1) the forms are aligned and printing should continue, 

or (2) the first line should be reprinted for realignment. 

If more than one copy of output is requested and ALIGN- 
YES is specified, the printer halts for forms alignment for 
each copy. If ALIGN-NO is specified, the printer does not 
stop. The ALIGN parameter applies only to the job step 
in which the PRINTER statement was included. It is ig- 
nored when print spooling is not active. If the parameter 
is not specified, ALIGN-NO is assumed. 


PRIORITY: A priority can be assigned to a job step to 
indicate its order of printing from the print queue. Priority 
O is the same as priority 1 except that 0 indicates that the 
job step is to remain on the print queue until released by a 
RELEASE command. Priority 5 is the highest priority. 
Within a given priority, job steps are scheduled for printing 
on a first-in, first-out basis. The PRIORITY parameter 
applies only to the job step in which the PRINTER state- 
ment was included. PRIORITY is ignored when print 
spooling is not active. If the parameter is not specified, 
the priority of the job at the time of execution is used. 


QCOPY (5704-SC2 only): This optional parameter can 
be used (QCOPY-NO) to prevent the spool file copy pro- 
gram (SQCOPY) from copying a job step that is on the 
print queue. QCOPY-YES allows $QCOPY to copy a job 
step. If the parameter is not specified, QCOPY-YES is 
assumed. 


The QCOPY parameter applies only to the job step in which 
the PRINTER statement was included. 


CLOSE (5704-SC2 only): This optional parameter can be 
used (CLOSE-NO) to group multiple print steps of a job 
as one job step under one stepname. If CLOSE-NO is 
specified, no further print steps of that job are closed at 
end of step, but they are closed at end of job. If 
CLOSE-YES is specified, a print step is closed at end of 
step. If the parameter is not specified, CLOSE-YES is 
assumed. 


The specified CLOSE parameter remains in effect for that 
Partition unti! another PRINTER statement with a CLOSE 
parameter is entered, or until the next end of job. The 
CLOSE parameter is ignored when print spooling is not 
active. 


If a previous print step specified CLOSE-NO, a PRINTER 
statement with an ALIGN, COPIES, DEFER, FORMSNO, 
PRIORITY, or QCOPY parameter is ignored and causes 
an information message. 


Considerations 


When a PRINTER statement is encountered and printer 
output for the job step is being spooled, the effect of the 
COPIES, DEFER, ALIGN, CLOSE, and FORMSNO param- 
eters is delayed until the print writer is ready to print the 
output. 


tf logging was assigned to the 1403, all OCL for the job 
step is included with the data. If multiple copies are 
requested (COPIES parameter), the OCL is included with 
each copy. Forms alignment is performed on the first 
OCL statement for that step. For these reasons, it may be 
desirable to suppress logging for those steps requiring 
multiple copies or forms alignment. 


If printer forms must be aligned during the printing of a 
step’s output (ALIGN-NO was not used), two methods 
can be used: 


1. If the step’s printed output is to be restarted from 
the beginning, the following steps can be taken: 
a. Enter a RESTART command to stop the print 
writer. 
b. Align the forms. 
c. Respond to the message PRT RESTART PENDING. 


2. If it is not necessary to restart, the following steps 
can be taken: 
a. Enter aSTOP PRT command to stop the print 
writer. 
b. Align the forms. 
c. Enter aSTART PRT command to resume printing. 


The system print device is used to print system output and 
can be changed in a spooled job stream. However, if the 
new system print device is not the 1403, printed system 
output is not placed on the print queue; rather, it goes 
directly to the system print device. To resume spooling 

of system printed output, the system print device must be 
restored to the 1403. 
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PUNCH 


During system generation, a system punch device is assigned 
to each partition. If the device is changed by a PUNCH 
statement, the new punch device remains in effect until 
changed by another PUNCH statement or until another IPL 
occurs. 


Functions 


@ Changes the system punch device for the Partition in 
which the statement was entered. 


@ Provides information related to a spooling environment. 


Placement 


The PUNCH statement must precede the RUN statement. 


Format 


// PUNCH parameters 


Contents 
The parameters are as follows: 
@ DEVICE-device 


@ CARDNO-nnn 


YES 
e perer.{* } 


@® COPIES-nn 


@ PRIORITY: 


aOfWN—| Oo 


YES 
e a 
QCOPY ts \ 


DEVICE: This optional parameter identifies the system 
punch device, which can be any of the following: 


@ MFCU1 — Primary hopper of the 5424 
@® MFCU2 — Secondary hopper of the 5424 


@ MFCM1 


Primary hopper of the 2560 
@ MFCM2 — Secondary hopper of the 2560 
@ 1442 ~— 1442 Card Read Punch 


@ 3741 — Directly attached 3741 Data Station or 
Programmable Work Station. The 3741 is 
not supported as a spool punch device. 


If the DEVICE parameter is not used, the device remains 
unchanged. 


CARDNO: This optional parameter is used to inform the 
Operator when to change card types in the punch and what 
cards to insert. Up to 3 characters can be used in any 
combination; commas, apostrophes, or blanks cannot be 
used. When this parameter is used, the punch writer issues 
a message (CHANGE CARD TO TYPE nnn) if the card 
type for the current punch step is different than the 

card type of the previously punched step. The param- 

eter is effective only for the step in which the PUNCH 
statement is included. 


DEFER: This optional parameter can be used to defer the 
spooled punched output of a step until the step has com- 
pleted execution. DEFER-NO allows the output of the 
step to begin punching before the job step has completed 
execution. DEFER-YES prevents punching until the step 
has completed execution. The DEFER parameter applies 
only to the job step in which the PUNCH statement was 
included. It is ignored when punch spooling is not active. 
If the parameter is not specified, DEFER-YES is assumed. 


COPIES: This optional parameter allows the user to ob- 
tain from 1 to 99 copies of a job step’s spooled punched 
output. If the parameter is not specified, only one copy 
is punched. When multiple copies are requested, the user 
must respond to the END OF PCH STEP message before 
the punch writer starts punching the next copy. Once 
started, the punch writer produces the number of request- 
ed copies before continuing to the next step on the punch 
queue. This parameter is effective only for the step in 
which the PUNCH statement is included. The COPIES 
parameter is ignored when punch spooling is not active. 


PRIORITY: A priority can be assigned to a job step to 
indicate its order of punching from the punch queue. 
Priority 0 is the same as priority 1 except that 0 indicates 
that the job step is to remain on the punch queue until 
released by a RELEASE command. Priority 5 is the highest 
priority. Within a given priority, job steps are scheduled 
for punching on a first-in, first-out basis. The PRIORITY 
parameter applies only to the job step in which the PUNCH 
statement was included. PRIORITY is ignored when punch 
spooling is not active. If the parameter is not specified, the 
priority of the job at the time of execution is used. 


OCOPY (5704-SC2 only): This optional parameter can be 
used (QCOPY-NO) to prevent the spool file copy program 
(SQCOPY) from copying a job step that is on the punch 
queue. QCOPY-YES allows $QCOPY to copy a job step. 
lf the parameter is not specified, QCOPY-YES is assumed. 


The QCOPY parameter applies only to the job step in which 
the PUNCH statement was included. 


Considerations 


When punching, the system does not verify that cards to 
be punched are blank. 


When punching spooled output on a 1442 or MFCM, spool 
may insert blank cards between decks to cause all cards of 
the deck just punched to be fed into the correct stacker. 
On the MFCU, the last card is stacked without the extra 
blank cards. 


The system punch device is used to punch system output 
and can be changed in a spooled job stream; however, if 
the new system punch device is not the spooled punch 
device, punched system output is not placed on the punch 
queue but goes directly to the new system punch device. 
To resume spooling of system punched output, the system 
punch device must be restored to the device designated as 
the spool punch device during system generation. 


When a PUNCH statement is encountered as the step is 


being executed, only the DEVICE parameter takes effect. 


The effect of the COPIES, DEFER, and CARDNO param- 


eters is delayed until the punch writer is ready to punch 
the output. 


Consider the following example: 

// PUNCH DEVICE-MFCU2,CARDNO-50 
If the previous punch step had a different card type 
prior to punching the current step, the system displays 


CHANGE CARD TO TYPE 50, informing the operator 
to change card type to 50. 


PUNCH 


67 


READER 


During system generation, a system input device is assigned 
to each partition. If the device is changed by a READER 
statement, the new input device remains in effect until 
changed by another READER statement or until another 
IPL occurs. 


Function 


Changes the system input device for the partition in which 
the statement is entered. 


Placement 


The READER statement must precede a LOAD or CALL 
statement. The READER statement must not be placed 
between the LOAD and RUN or the CALL and RUN 
statements. 


If the READER statement is used in a procedure, the sys- 
tem input device is changed when the READER statement 
is processed, but OCL statements are not read from the 
new system input device until the procedure is completely 
executed. 


The system input device is used to read source statements, 
control statements, and OCL statements. Changing the 
system input device affects the placement of these 
statements. 


Format 


// READER code 


Contents 


code: The selected code identifies the system input device; 
it can be one of the following: 


@ CONSOLE ~— 3277 Display Station (CRT/Keyboard) 


@ MFCU1 — Primary hopper of the 5424 
@ MFCU2 — Secondary hopper of the 5424 
@ MFCM1 — Primary hopper of the 2560 
@ MFCM2 ~ Secondary hopper of the 2560 
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@ 1442 — 1442 Card Read Punch 
@ 2501 — 2501 Card Reader 
e@ 3741 — Directly attached 3741 Data Station 


or Programmable Work Station 


Considerations 


The system input device can be changed in a spooled job 
stream; however, if the new system input device is different 
from the spooled input device, jobs are not scheduled for 
execution from the reader queue. To resume scheduling 

of jobs from the reader queue, the system input device 
must be restored to the device designated as the spooled 
reader during system generation. 


Consider the following example, which illustrates how an 
optional step can be executed. 


Assume that the following cards are in MFCU1, which is 
the spooled input device: 


//JOB1 JOB 
//CALL PAYROL,R1 
// RUN 


// READER MFCU2 
//CALL ANALYS, R1 
// RUN 

[: 

/. 


And assume that MFCU2 contains these cards: 


// LOAD SPECAL,R1 
// RUN 
// READER MFCU1 


When the // READER MFCU2 statement is encountered in 
the input job stream, the system input device is changed 

to MFCU2. The system reads the next OCL statement 
from MFCU2. If it is not necessary to execute the program 
named SPECAL, then only the READER statement is 
needed in MFCU2. 


The /. statement is a job stream delimiter. 


Functions 


@ Separates jobs, causes end of job, and prevents the read- 


ing of more OCL for the job. 


@ Indicates the end of the spooled input job stream if 
spooling is active and if two consecutive /. statements 
are used. 


@ Changes the partition from job mode to step mode, if 
spooling is not active, by causing end of job in the 
partition in which the statement is entered. 


Placement 


The placement of this statement is determined by how it 
is used in the job stream. The /. statement is not allowed 
in a procedure. Because a job cannot be executed as an 
inquiry program, the JOB and /. statements are ignored if 
a rollin is pending for that partition. 


Format 


Content 


None (comments may begin in position 3). 


Considerations 


A /. statement can be used to delimit jobs in a job stream. 
When a job being put into the reader queue is not termin- 
ated by a /. statement, the reader (input spooling routine) 
generates a /. statement as the last statement for the job 
in the queue; the /. statement is generated when the next 
JOB statement is encountered. This generated statement 
may contain extraneous characters following the /. that 
appear when the system history area is displayed or 
printed, or when the statement is logged on the system 
logging device. 


Some programs (for example, $COPY) do not recognize 
a /. statement with comments or extraneous characters 
as end of file unless the statement ts supplied by the 
system reader. Such programs should not attempt 

to read from the spool reader unless it is also the system 
reader. 


The following examples show how the /. statement can 
be used. 


1. Used as a delimiter between jobs: 


//JOB1 JOB 
//STEPA LOAD PROGA,R1 


// RUN 
Data 
/* 
/& 
//STEPB LOAD PROGB,R1 
// RUN 
Data 
/* 
/& 
hs This indicates the end of the JOB1 and prevents 
the reading of more OCL for JOB1. If any job 
steps in JOB1 had been canceled, the /. indicates 
the end of the job. If this statement were not 
in the job stream, the following invalid JOB 
statement and the following LOAD and RUN 
statements would have been read as part of the 
OCL for JOB1: 
//SOB2 KOB 
//STEPA LOAD PROGC,R1 
// RUN 
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Used to indicate the end ct spooled data. 


//JOB1 JOB 
/ISTEPA LOAD PROGA,R1 


// RUN 

Data 

ie 

/& 

//STEPB LOAD PROGB,R1 
// a 

Data 

Ae 

/. 

//JOB2 JOB 

//STEPA LOAD PROGC,R1 
// RUN 

Data 

/* 

/& 

//STEPB LOAD PROGD,R1 


// RUN 
Data 

TE 
/. 


/ \ Indicates end of spocied input. 


Used to end job mode and return to step mode 
{(nonspooled systems only). 


//JOB1 JOB SPOOL-NO,PARTITION-1,CORE-12 
/ISTEPA LOAD PROGA,R1 


// RUN 

Data 

/* 

/& 

//STEPB LOAD PROGB,R1 


// RUN 

Data 

/* 

/. Ends job mode. Begin step mode. 
// LOAD PROGC,R1 

// RUN 


The upper part of Figure 7-1 shows the processing of a Sys- 
tem/3 Model 15 job stream in a partition without the spool- 
ing facilities. The first job, which needs a great deal of 
printing time, slows down throughput. The lower part 
shows the processing times of the same job stream with 
spooling. Here, the total time is divided into processing 
time, queue time (the time the output of the job is in the 
print queue, ready for printing), and printing time. (Input 
spooling and multiprogramming are not considered in this 
example.) 


Although the time elapsed between the reading of a job 
and the completion of its output increases when using 
spooling, overall system performance is usually improved. 
This can be seen from the difference between points 2 

and 3 when all five jobs have finished processing. In addi- 
tion, the processing unit is available for processing because, 
between points 1 and 2, the only activity is the printing of 
the spooled print data which requires little processing unit 
time. 


This is only a theoretical example of spooling performance 
in a single batch environment. The actual increase in 
throughput achieved depends, for example, on the 1/O 
orientation of each program, the sequence of the particular 
jobs, and the speed and number of unit-record devices. 


PERFORMANCE FACTORS 


Performance of a system varies widely whether or not spool- 
ing is used. In some cases, there may be little or no advan- 
tage in spooling. In other cases, spooling provides substan- 
tial benefits to overall application throughput. Therefore, 

it is important to evaluate each application separately. It 

is very difficult, if not impossible, to predict the performance 
of a spooling system. 


There are many factors that affect performance; when mea- 
suring the performance of a system, these factors should be 
considered. Consideration of these items can result in im- 
proved performance. (Specific spooling techniques are not 
included.) 


Chapter 7. Performance 


System Considerations 


@ Speeds of |/O devices, for example: 
— The Model 10 has both a regular and a high-speed 
5444 disk drive available; the Model 15 has only 
the high-speed 5444. 
— Printer performance is affected by the print chain/ 
train that is used. 


@ Number of 5445/3340/3344 drives used; device conten- 
tion can affect spool performance. 


Application Considerations 


@ Job mix in each partition: 
— Single batch vs multiple batch 
— Single or dual batch and communications 
— Single or dual batch and inquiry 
— Unit-record 1/O vs disk/tape 1/O 


@ Relationship of steps within a job; dependency of one 
step on a preceding step. 


@ Volume of data: 
— Number of print lines and number of pages 
— Number of cards read 
— Number of cards punched and/or printed 
— Large volumes of unit record !/O tend to favor 
spooling 


@ Sequence and priority of jobs: 
— Job priority affects the sequence in which it is 
executed. 
— The first job should have a small amount of card 
input, so execution can begin while the remainder 
of the job stream is being read to disk. 


| ocation of files: 

— The spool file should be on a dedicated 
5445/3340/3344, or on a 5445/3340/3344 
with nonactive (backup) files. 

— Use of automatic work file allocation can increase 
run time and prevent optimum file location. 

— Files should be located to minimize access arm 
movement. 
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The improvement in system performance achieved by out- 
put queueing when spooling is shown by the difference in 
time between points 2 and 3. (Printing can begin prior to 
the completion of the program.) 


Figure 7-1. Processing Five Jobs with and without Spooling 
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User Program Considerations 


File organization and access methods used: 

~ Direct files may provide greater performance than 
indexed files. 

— Processing of indexed files requires more seeks 
(index and data). 


Use of data management options: 

— Double buffering 

— In-core index 

— Block size 

— External buffers (5704-SC2 only) 
Disk file sharing (5704-SC2 only) 


Complexity of processing: 

— Number of unit-record |/O operations per logical 
program cycle 

— Balance of unit-record 1/O and disk/tape/process- 
ing unit operations 

— Processing oriented; unit-record oriented; or disk/ 

tape oriented 

Use of program overlays 


Partition size: 

— Affects compilation time 

— Affects sorting 

— Affects the number of memory resident overlays 
in storage at one time 


Operational Considerations 


@ Spooling options: 


— Level of spooling support (input/print/punch); 
affects main storage available to the partition(s). 

— Partitions spooled (1, 2, or 3); affects processing 
unit contention. 

— DEFER-NO; overlaps printed or punched output 
with program processing. 


@ Logging device: 


— Use of 3277 in one partition may tie up another 
Partition. 

— Suggest not using 3277 to enter OCL or data. 

— If logging messages to a spooled printer, the OCL 
is spooled along with any printed data. If there 
is no data, OCL is spooled anyway requiring disk 
space and time. 


Halt/Nohalt: The halt or nohalt mode and severity 
level affect operator involvement. 


Operator familiarity with the job stream: 

— Can reduce contention situations. 

— Operator should be familiar with messages and 
action to be taken. 


Performance 
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The following problem situations may be encountered 
when you use spooling. 


SPOOL FILE IS FULL 


When space is no longer available within the spool area on 
disk, the error message SPOOL FILE IS FULL appears on 
the CRT. If the print or punch queues contain job steps 
that are ready to be printed or punched or if the reader 
queue contains jobs waiting for execution, this space can 
be freed. The print and/or punch writers can be started or 
the jobs on the reader queue can be canceled in order to 
relinquish the disk space being occupied by the queues. 
Entering a REUSE command can make some space 
available before a writer completes the output for a print 
or punch step. When the operator responds to the 
SPOOL FILE IS FULL message, spool attempts to obtain 
space. If space is available, the partition continues to run; 
otherwise, the diagnostic message is issued again. 


When the SPOOL FILE 1S FULL message appears and all 
the queues are empty, the job must be rerun. If the size of 
the spool! area is less than 199 cylinders for 5445, 166 cyl- 
inders for 3340 main data area, or 186 cylinders for a 3344 
main data area, do the IPL again and start spool with a 
larger size for the spool area. 


If it is not possible to increase the size of the spool area, 
you can remove steps from the print queue or punch queue 
by starting the appropriate writer. Also, jobs on any of 
the queues can be canceled in order to make space avail- 
able. Entering a REUSE command can make some space 
available before a writer completes the output for a print 
or punch step. For future runs, using less input data can 
make space available for other jobs on the reader queue. 


Chapter 8. Problem Situations 


PERMANENT DISK ERRORS 


If a significant performance degradation occurs on frequent 
ly run jobs, have your customer engineer check the error 
logging area to determine 1f temporary disk errors Have been 
occurring on the disk drives coritaining the spooling area 
and the data files. When permanent disk errors occur, the 
operator is notified with a message. However, wnen 
temporary errors occur, the system can perform up ta 

256 retries before continuing. If temporary errors occu! 
frequently, the time required to perform retries and to log 
these errors can cause a performance degradation. If 
changing data file locations and using a disk pack with no 
alternate tracks for the spooling area do not relieve the 
problem, contact your IBM representative. 


If disk errors occur within the spool file, the reader cr 
writer that was accessing the file at the time of the error 
is terminated when the message is responded to. For 
example, if the system supports input, print and punch 
spooling, and if a disk error occurs while the punch writer 
is accessing the spool file, the punch writer is terminated 
The reader and print writer may not be affected. 


DEVICE FAILURES 


The failure of a unit record device normally causes system 
operation to stop. However, if spooling is supported, ap- 
plications can be executed even though ihe unit record de- 
vice is not available. If the spool reader is unavatiable, all 
the jobs that were placed in the reader queue can be exe 
cuted. If the printer or punch Is unavailable, the output 

for these devices will be saved in the print and punch queues 
until the device becomes available and the print ot punch 
writer is initiated. 


LOST JOBS OR JOB STEPS 


The following conditions can cause jobs or steps to be 
lost: 


@ The operator IPLs the system during processing. 


@ A programming error causes a processor check, as in- 
dicated by the red processor check light. 
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A display of system status indicates that disk space has been 
lost if (1) all queues are empty, and (2) the total number of 
track groups does not equaj the number of available track 
groups. 


Entering a START SPOOL, NEW command at IPL is the 
only way to recover the lost disk space. 
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If more printing capacity is needed for a System/3 Model 
15D, a second 1403 printer can be attached and a second 
spool print writer can be selected during system genera- 
tion. (An RPQ is required to attach a second 1403 printer.) 
The second print writer functions identically to the first 
print writer; anything in the print queue can be directed to 
the second printer. 


No changes to any OCL statements or programs are 
required in order for spooling to print output on the 
second printer. However, no support is provided to use 
the second printer directly without spooling it. 


The system generation autostart and autowrite options 
apply to both print writers. if autostart, for example, is 
selected for the printer during system generation, auto- 
start applies to both print writers when spool is started 
after an IPL. 


The only chain image that can be used by the second 
printer is the one specified for the system printer during 
system generation. For example, if the printed output 
from job A requires a special print chain or train, job A 
must be printed on the first printer because the chain 
image of the second printer cannot be changed. For more 
information on the chain image, see Changing the Print 
Chain/Train in Chapter 2. 


OPERATOR CONTROL COMMANDS 

The START, STOP, and RESTART operator control 
commands each have two additional operands available 
when the second printer is selected during system 


generation. 


Operand PR1 (W1) has the same effect as PRT (W); either 
can be used to start, stop, or restart the first print writer. 


Operand PR2 (W2) applies only to the second print writer. 


Chapter 9. Second 1403 Printer 


Consider the following examples: 


1. START PR2,CHK 
or 
S W2,CHK 


This command causes the second print writer to 
print only those job steps with a forms type of CHK. 


2. STOP PR2,STEP 
or 
P W2,ES 


This command causes the second print writer to 
terminate at the end of the current step or copy. 
When the PR2 WRITER TERMINATED message is 
issued, the operator can start the second writer with 
a different forms type operand. 


3. RESTART PR2,PAGE 
or 
T W2,PG 


This command causes the second print writer to 
restart printing at the beginning of the page on which 
the writer was terminated. If, for example, the 
second print writer was terminated on page 78 
because of an 1/O error for which a cancel option 
was taken, this command would cause the writer to 
restart printing at the beginning of page 78. 


OPERATIONAL CONSIDERATIONS 


Three methods can be used to control which printer will 
print which print steps: 


@ When both writers are started without a forms type 
operand, they print the spooled job steps on a first-in, 
first-out basis. (This is the method in effect when 
autostart is used for the print writers at IPL.) This 
method is effective if most job steps have the same 
forms type. 
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® When one print writer is started with a forms type 
operand and the other without, the writer started 
without a forms type operand can print any forms type 
except the one specified for the other print writer. If 
approxiunately half of the total printing is on one forms 
type, this method can restrict all of the forms changes 
to one printer. 


@ When both writers are started with a forms type oper- 
and, each prints only the jobs steps with its specified 
forms type. Both writers can be started with the same 
forrns type operand. 


If a job step has multiple copies, all copies will be printed 
by one printer, even though the other printer is idle. 


PRINT QUEUE DISPLAY 


In the print queue display for a system with two print 
writers, an A appears before the Priority number if the 
job step is currently being printed by the first print writer 
(PR1); a B if by the second print writer (PR2). 


If one of the print writers was started using the forms type 
operand, the active forms type is displayed in one of the 


following messages: 


PR1 xxx ACTIVE FORMS TYPE 
PR2-xxx ACTIVE FORMS TYPE 


If both writers were started using a forms type, the follow- 
ing message is displayed: 


PR1-xxx PR2-xxx ACTIVE FORMS TYPE 


The following is an example of a print queue display when 
both writers were started with a forms type operand: 








FRM CPY PAGES 
ACTIVE FORMS TYPE 






L 4 BCD 1 40 
e 4 BCD J. 24 
3 AZ CKS 2 16 
REGISTER 4 B3 REG UL L6 
YTDMASTR > 3 STK 4 136 


END GF QUEUE 





MSG NOT RSP O05 
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MAIN STORAGE REQUIREMENTS 


The main storage requirement for the second print writer 
is 2.02K. For more information on main storage require- 
ments, see Appendix B. 


The spool area (named $SPOOL in the VTOC) contains up 
to three queues (a reader queue, print queue, and punch 
queue) depending on the options selected during system 
generation. The queues are not fixed in size, and can con- 
tain a variable number of entries. Any queue is not con- 
sidered full until all available disk space within the spool 
area has been used. 


$SPOOL is allocated a permanent file from the highest 
available cylinder (5704-SC1), or from the lowest avail- 
able cylinder (56704-SC2). For example, a 50-cylinder 
spool file on a newly initialized 5445 disk will be in 
cylinders 151-200. 


The basic structure of the spool area is similar to a parti- 
tioned data set. The area is divided into track groups of 
1, 2,4, 5, or 10 tracks. An index within the area contains 
an entry for each track group. The first 256 bytes in the 
spool area is a master record that contains the pointers to 
all the indexes within any one queue or all the available 
indexes. 


Appendix A. Format of the Queues 


Each index contains the beginning and end disk addresses of 
a unique track group within the spool area. The number of 
spooled input, print, or punch records can vary within a 
track group. Spool records on disk can vary in length and 
are written in the following format: 


fe] 


Where K is 1 to 4 bytes of control information including 
the length of the record. 





Spooled record | 





MASTER IX3 track group, track group 4 track group, 














———— se. he 
A a eee PAULL yet. Input IX eee Input IX, 
S 
E _ 
ie a eee inti, ee 
R 
E ,.. 7a. Punch 1X4 Punch IX | 0... Punch IX, 
Cc Ue ee eee 
Oo 
3 ae 
D 





| Available 1X | Available 1X5 I Available IXp 
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Appendix B. Main Storage Requirements 


Figure B-1 will assist you in estimating the main storage 
requirements for various levels of spooling support. 
Additional requirements depend on the options you 
select during system generation. (For information on 
SCP programs, program products, and data management 
routines, see /BM System/3 Model 15 System Generation 
Reference Manual, GC21-7616.) Some of the options are: 


@ Support for the following devices: 
~ 3284 Printer 
3410/3411 Magnetic Tape Subsystem 
— 3340 Direct Access Storage Facility 
— 3741 Data Station or Programmable Work Station 
Second 1403 Printer 


| 


@ Support for the following processing unit features: 
— Interval Timer 
— Binary Synchronous Communications Adapter (BSCA) 
— Binary Synchronous Communications Controller 
(BSCC) 
— Multiple Line Terminal Adapter (MLTA) 
— Seriai 1/O Channel (SIOC) 
— Unit Record Restart 


@ Support for the following functions: 
— 1/O Storage Protection 
— Communications Control Program (CCP) 
— Number of partitions supported by spooling 
-— Spooled reader device 
— Spooled punch device 
— Memory resident overlays 


LEVEL OF SPOOLING SUPPORT 


Print| Print/Punch Input/Print/Punch 
wos [ x{xixix|{ xix] xi x[x][x[ x] x] 


MFCU 
Punch 
; MFCM 
Device 
1442 




















Input 
Device 


Three Partitions 9.75/15.91]16.70 5.31|15.80 15.84]15. : . 7 : -99}19.95 {20.79 
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120. 74119.86 





Figure B-1. Estimated Main Storage Requirements of Spooling Support 
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The following formulas can be used to estimate the amount 
of 5445/3340/3344 disk space (in cylinders) required for the 
the spoo! area. (102,400 is the number of bytes per cylinder 
on a 5445 disk, and 245,760 is the number of bytes per 
cylinder on a 3340/3344 disk.) 


1. Spool requirement: 


Disk space = 1.1 (A +B + C) +2 cylinders 


where: 
A = Disk space to contain spool input records 
B = Disk space to contain spool print records 
C = Disk space to contain spool punch records 

2. Spool input requirement: 
A = NxL 
(input disk space) S 
where: 


A = Figure (rounded up to nearest integer) to be 
used in #1 

N = Maximum number of input records to be 
contained on disk at any one point in time 

L = Length of the input record (80 or 96) 
{use average length if input is from a 3741 
except if put on the reader queue by 
$QCOPY) 

S = 102,400 for a 5445 or 245,760 for a 
3340/3344 


3. Spool print requirements: 


Nx L 


B 


(print disk space) S 


where: 


B = Figure (rounded up to nearest integer) to be 
used in # 

N = Maximum number of print records to be 
contained on disk at any one point in time 

L = Average length of print records 

S = 102,400 for a 5445 or 245,760 for a 
3340/3344 
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4. Spool punch requirements 


c GPUS 


t 


(punch disk space) S 


itx Lb 


where: 


C = Figure (rounded up to nearest integer} to be 
used in +1 

P = Maximum number of puncn records to be 
contained on disk at any one paint in time 

LP= Average length of the punch records 

| = Maximum number of punch records with 
printed data to be contained on disk at any 
one point tn time 

LI= Average length of the printed data on those 
cards 

S = 102,400 for a 5445 or 245,760 far a 
3340/3344 


Example: 


This example illustrates the use of the four formulas on a 
system with a 5445 disk. An installation wants the spool 
area to contain 4000 input records, 2 hours of printing, and 
2000 punch records. The installation includes an MECU 
and a 1403 Model 2 Printer (600 ipm} The MECU is the 
spooled input and punch device. It has beer estimated 

that the average print record tength ts 100 bytes, the average 
punch record is 80 bytes, and that hatf of the punched 
output contains printing with an average length of 75 oytes. 





A 4000 records x 96 by tes 


(input) 102,400 byies/cylinde: 





3.75, or 4 cyitnders 


The next calculation converts the Nours of print time to 


number of records. 


2 hrs x 60 min/hr x GOG lines/min = 72.000 tines or 





records. 

B _ 72,000 records x (100 bytes FOS, or 71 
(print) 102,400 bytes/cviinder oylinders 
Cc — (2000 x 86) H1006 x 75) 


= : 2.29, or 3 cylinders 
(punch) 102,400 bytes/cylinder) 


Required disk space = 1.7 (4+ 71 + 3) + 2 87.80, or 88 
cylinders. 
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Appendix D. Size of Track Groups 


The spool area on disk is used for the reader, punch, and If a large number of jobs is expected to be queued and disk 
Print queues. Space is allocated as required by the spool- space is small, the track group size should be small. 

ing routines; each time space is needed for a queue, another 

track group is assigned. The number of track groups with- {f a small number of jobs is expected to be queued, the track 
in a given number of cylinders depends on the size of each group size should be as large as possible. 


track group. The size of each track group is determined by 


the user (1, 2, 4, 5, or 10 tracks). If a mix is expected, a compromise between these two 
suggestions must be made. 

Figure D-1 shows the number of track groups that will be 

produced in the spool file based on the size of the spool Entries in the spool area begin on track group boundaries: 

file and the track group size. 


@ Each job on the reader queue 
A small track group size reduces the amount of wasted space 


in the spool file. However, some performance may be sacri- @ The printed output for each step (including the OCL 
ficed if the spooling routines must obtain space more fre- for that step if the logging device was spooled during 
quently. Therefore, user application requirements and char- program execution) 
acteristics determine which track group size to use. In 
general, the following guide may be used. @ The punched output for each step 
5445 3340/3344 
ALLOCATED TRACK GROUP SIZE ALLOCATED TRACK GROUP SIZE 
CYLINDERS 1 2 4 5 10 CYLINDERS 1 2 4 5 10 
10 195 98 49 39 19 10 197 98 49 39 19 
20 390 =6197 99 79 39 20 395 198 99 79 39 
30 585 296 149 119 59 30 593 298 149 119 59 
40 780 395 198 159 79 40 791 397 199 159 79 
50 975 493 248 190 99 50 989 497 249 199 99 
60 1170 592 298 238 119 60 1187 596 299 239 119 
70 1365 691 347 278 139 70 1385 696 349 279 139 
80 1560 790 397 318 159 80 1583 795 398 319 159 
90 1755 888 447 358 179 90 1781 895 448 359 179 
100 1951 987 496 398 199 100 1979 994 498 399 199 
110 2146 1086 546 437 219 110 2177 1094 548 439 219 
120 2341 1185 596 477 239 120 2375 1193 598 478 239 
130 2536 1283 645 517 259 130 2573 1293 648 518 259 
140 2731 1382 695 557 279 140 2771 1392 698 558 279 
150 2926 1481 745 597 299 150 2969 1492 748 598 299 
160 3121 1580 795 636 319 160 3166 1591 797 638 319 
170 3317 1678 844 676 339 170 3364 1691 847 678 339 
180 3512 1777 894 716 359 180 3562 1790 897 718 359 
190 3707 1876 944 756 379 


Figure D-1. Number of Track Groups for Model 15 Spooling 
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Message 


SPUTAD 
SPUTAF 
SPUTAG 


SPUTAP 
SPUTBF 


SPUTCA 
SPUTCA 


SPUTCA 
SPUTCC 
SPUTCF 
SPUTCH 
SPUTCS 
SPUTDE 
SPUTDF 
SPUTEP 
SPUTFA 


SPUTFF 
SPUTFZ 
SPUTIE 
SPUTIF 
SPUTJE 
SPUTJQ 
SPUTNA 
SPUTNF 
SPUTN! 
SPUTNP 
SPUTNR 
SPUTNS 


Reason /Meaning 


The spool device is being used 

Align forms to line 1 

Align forms to line 1 of second printer 
(5704-SC2 only) 

A print restart is pending 

An error was found in the spool file queues 
(5704-SC2 only) 

Cannot accept CHANGE copies command 
(5704-SC2 only) 

Cannot accept HOLD command (5704-SC2 
only) 

Cannot accept RESTART command 
Change card type 

Change form type 

Spool file disk error 

Cannot spool this job 

Spool file disk error 

The spool file contains data 

End of punch step 

Spool file attributes at spool start (5704-SC2 
only) 

The spool file is full 

Form size change required 

Disk error on spool file index 

An invalid spool file was found 

The JOB statement is in error 

Reader queue job started 

The requested queue is not supported 
Jobname or stepname was not found 

No input jobs are available 

NPRO the punch device 

Program input device is the spool reader 
Not enough disk space 


Message 


SPUTPR 
SPUTPT 
SPUTPW 
SPUTOE 
SPUTRE 
SPUTRH 
SPUTRP 
SPUTRQ 
SPUTRO 
SPUTRT 
SPUTSA 
SPUTSF 
SPUTSH 
SPUTTM 
SPUTWA 
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Reason/Meaning 


A punch restart is pending 

The punch writer is terminated 

The print writer is terminated (on page nnnnn) 
The print/punch queue is empty/held 

The reader queue is empty/held 

The print restart is halted 

Ready the punch device 

Job/step/queue was affected by a command 
nnnn track groups available 

The reader is terminated 

Spool is active 

The stacker is full 

Spool is halted 

Start date and time, and end time 

The reader/writer is active 


For a detailed description of these messages, see /BM 
System/3 Model 15 System Messages, GC21-5076. 
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Appendix F. Operator Control Commands (OCC) Summary 


INFORMATION ABOUT SYNTAX ILLUSTRATIONS 


@ Uppercase letters, numbers, and commas must be 
entered as shown. Parentheses () indicate an abbrevia- 
tion for the item above. Do not enter brackets, braces, 
or parentheses. 


@ Lowercase items represent variables. 


@ Items or groups of items within brackets [ ] are optional 
—enter one or none. 


@ Items in braces are alternatives—enter one. 


©@ Optional items that are underlined indicate the default 
value. If none of the items are entered, the default value 
is used. 


®@ All operands are positional. Operands must be entered 
in the order shown. !f any operand (except the last) is 
omitted, a comma must be entered in its place. 


@ There must be at least one blank between the command 
and the operands. The first blank after the start of the 
operands terminates the operands. There must be only 
blanks after the last operand. 


OCC LIST 


Operator control commands (OCC) allow the operator to 
communicate with the sytem. All OCC are entered from 
the CRT/keyboard. By using OCC, the operator can 
communicate with the system before, during, or after job 
execution. The following is a complete list of OCC. Fora 
complete description of OCC, see the /BM System/3 
Model 15 Operator's Guide, GC21-5075. 
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Command Operand Function 


CANCEL SPOOL Cancels spooling support 
(CN) (SP) {at IPL only). 

RDRQ, { jobname Cancels a job or a job step, or 

(RQ) ale multiple jobs or job steps. 

PRTQ, { jobname } [ ,stepname | 

(WQ) characters” * ,characters*”* The characters”* operand 

PCHQ, eee \ ;stepname is for 5704-SC2 only. 

(PQ) characters* * [ ,characters* | 

*RDRO Cancels an entire queue. 

(*RQ) 

*PRTO 

(*WQ) 

*PCHO 

(*PQ) 

rif Cancels program execution ina 
3 partition. The 2 or 3 following 
9 the P1, P2, or P3 indicates the 

raf] option of the cancel. 
9 P3 operand is for 5704-SC2 

raf] only. 
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Command 


CHANGE 
(G) 


DATE 
(DT) 


Operand 
CORE,size [ Rone aes 
aa characters” * 
( wi 
(WQ) aes 
CPY, [number] , 
fea \ characters 
(PQ) 
CRD, card type, | ane. 
(PQ) characters” 


FRM, forms type, [ 


(wQ) characters” 
1 
2 
3 
PTN, A ; [ARG io 
B (RQ) ] characters” 
Cc 
D 
/ 4 \ ( RORQ, oe 
9 (RQ) characters* * 
PTY, PRTQ, {iebare 
(Y) 3 (WQ) characters 
4\ J PcHa, {omen 
5 (PQ) characters 
we 
mmddyy ‘ 
dd/mm/yy 
ddmmyy \ 


PRTQ ] { jobname 


stepname 
ae ,characters” 
,stepname 
* ,characters” 
»stepname 
+* * 
,characters 


‘ 


,stepname 
ae ,;characters”* 


i ,stepname 
wf ,characters* * 
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Function 


Changes the main storage 
requirements, number of 
copies, card type, forms 


type, partition assignment, 


or priority of a job or job 
step or multiple jobs or 
job steps. 


The characters** 
operand is for 
5704-SC2 only. 


Sets the system 
partition dates. 
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Command 


DISPLAY 


(D) 


DUMP 
(K) 


Operand 
P1 
,P2 
STATUS P3 
iN 


HISTORY [task | [ ,task | 
(H) 


SYST 
(S) 


/DISK] 


Function 


Displays the system status, 
Partition status, and area 
names. 


Pn and N operands are 
for 5704-SC2 only. 


Displays the history either 
of the entire system or of 
one to seven tasks. 


Task operands? are for 
5704-SC2 only. 


Displays service aids options. 


Displays main storage. 


Displays the contents of the 
spooling queues. 


Causes a dump of any 
Partition or all of main 
storage to a printer; or 
dumps main storage, 

SWA, saved transient 

area, part of SHA, 
configuration records, 

PTF log sectors, microcode 
levels, and error recording 
data to $SYSDUMP file. 


P3 and DISK operands 
are for 5704-SC2 only. 


"Possible task operands are P1, P2, P3, S, SP, OCC, CCP, CCS, CCU, C44, C55, C66, C77, C88, C99, CCC, CDD, CEE, 


CGG, CHH, CMM, CPP, CTT, CUU, CVV, CWW, CXX, CYY, CZZ. 


F-4 


Command Operand Function 


HALT PL Causes the partition to halt 
(HT) P2 with an EJ or ES message 
P3 after the current job step is 
complete. 
SHA ,CCP ,tracks Causes the system to halt 


or $HACCP to be 
automatically invoked 
under CCP before unprinted 
system history area entries 
are overlaid. 


CCP and tracks operands 
are for 5704-SC2 only. 


HIPTY high-priority Limits the priority of jobs 

(HP) placed on the active spool 
file reader queue by 
$QCOPY under CCP 
(5704-SC2 only). 


HOLD “ RDRO oo ‘ Prevents a job, a job step, 
(H) \ (RQ) characters multiple jobs or job steps, 
/ PRTO ees a ee |] or an entire queue from 
(WO) ,characters ,characters being scheduled for 
jobname ;Stepname input or output. 
PCHQ ae [ 1 
‘ (PQ) characters ,characters os 
The characters 
operand is for 5704-SC2 
only. 
IDELETE Causes the system to 
(1) : automatically delete I- 


type (informational) 
messages to which there 
was no response (when 
there should have been 
a response.) 
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Command 


KEEP 
(KP) 


NOHALT 
(NHT) 


NOIDELETE 
(NI) 


PTY 
(Y) 


READER 
(RDR) 


RELEASE 
(R) 


RESTART 
(T) 


REUSE 
(RU) 


F.6 


,stepname 
,characters* 


;stepname 
,characters”* 


1 


,stepname 
,characters* * 


,stepname 
,characters** 


\ 


Operand 
RODRQ, oo } 
(RQ) characters** 
PRTQ, 4 ioteaiis 
(WQ) characters” * 
PCHQ, joie i 
(PQ) characters” * 
PL 
P2 
P3 
SHA 
SPOOL 
(SP) 
PI 
P2 = 
P3 
Pa 
P2 |,device 
P3 
jobname 
RDRQ havaviocce® 
(RQ) ic aie ers 
,jobname 
PRTQ [ a [ 
(wa) ,characters 
PCHO frees [ 
(PQ) ,characters 
PRT on 
(W) 
Number 
PRI | pg) 
(W1) 
Number 
PR2 | pg) | 
(W2) 
NuMber 
PCH 
(P) 
PRTQ . 
mm ,jobname [,stepname] 
PCHO . 
t tea) ,jobname[,stepname] 
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Function 


Keeps single or multiple printed, 
punched, or executed jobs 
and/or job steps on the queue 
(5704-SC2 only). 


Changes the processing mode 
of a partition from halt 

to nohalt or allows system 
history area entries to be 
overlaid without operator 
notification. 


Causes the system to cease 
automatic deletion of I- 
type messages that received 
no response. 


Changes the priority for 
the system tasks: 
spooling (reader, print 
writer, punch writer), 
partition 1, partition 2, 
and partition 3. 


Changes the system input 
device for a partition. 


Releases a job or job step, 
multiple jobs or job steps, 
or an entire queue from the 
hold state. 


The characters” * operand 
is for 5704-SC2 only. 


Restarts a job step’s printed 
or punched output. 


PR1 and PR2 operands are 
for 5704-SC2 only. 


Frees space in the spool file 
from the currently printing 
or punching job step 
(5704-SC2 only). 


Command 


ROLLOUT 
(RO) 


SET 


SIMULATE 
(SM) 


START 
(S) 


Operand 


size 


,P1 
SPOOL | ,P2 
(SP) ,P3 


{,NEW] [,unit] (,size] [,track-group-size] 


RDR [,ROLL] 
(R) 


PRT [,forms type] 
(W) 


PR1[,forms type] 
(W1) 


PR2[,forms type] 
(W2) 


PCH 
(P) 


P1 
P2 
P3 


Function 


Interrupts a roliout- 
evoking program to allow 
another program to be 
loaded and executed 
(5704-SC1 only). 


Overrides the partition 
and file share area size 

specified during system 
generation. 


Enables or disables 5444 


simulation on 3340 drive 2 
(5704-SC1 only). 


Restarts spooling in the 
designated partition. 


Starts spooling at IPL. 
Starts the spooled reader, 


print writer(s), or punch 
writer. 


PR1 and PR2 operands are 
for 5704-SC2 only. 


Restarts program execution 


in a partition (5704-SC2 only). 
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Command 


STOP 
(P) 


TIME 
(TM) 


TLOG 
(TL) 


TRACE 
(E) 


F-8 


Operand 


SPOOL , 
(SP) | 


RDR 
(R) 


STEP 
(ES) 
PAGE 
(PG) 


»STEP 
PR1 | (ES) 
(W1)] ,PAGE 


aN 


Careers 


(PG) 
/STEP 
(ES) 
“PAGE 
(PG) 
“STEP 
(ES) 


PR2 
(W2) 


PCH 
(P) 


> 
P3 


oe { 
hhmmss ‘ 


\orF} 


( 
lorry SYSTEM 


Function 


Terminates spooling in the 
designated partition. 


Stops the spooled reader, 
print writer(s), or punch 
writer. 


PR1 and PR2 operands are 
for 5704-SC2 only. 


Stops program execution in 
a partition (5704-SC2 only). 


Sets time-of-day clock. 


Enables or disables the 
currently loaded transaction 
logging routine (5704-SC2 only). 


Enables or disables the 
system trace routine 
(which must be currently 
loaded). 


This glossary contains terms used in this manual. If you do 
not find the term you are looking for, refer to /BM 
System/3 Model 15 Introduction, GC21-5094. 


{BM is grateful to the American National Standards Insti- 
tute (ANSI) for permission to reprint its definitions from 
the American National Standard Vocabulary for Informa- 
tion Processing (Copyright 1970 by American National 
Standards Institute, Incorporated), which was prepared 

by Subcommittee X3K5 on the Terminology and Glossary 
of the American National Standards Committee X3. 


An asterisk (*) preceding a definition in the list below 
indicates an American National Standard definition. 


activate: To make spooling support ready to operate; 
spool becomes inactive once a CANCEL SPOOL or STOP 
SPOOL command is issued. 


application program: A program written for or by a user 
that applies to the user’s own work. 


batch processing: *(1) Pertaining to the technique of exe- 
cuting a set of computer programs such that each is com- 
pleted before the next program of the set is started. (2) 
Pertaining to the sequential input of computer programs 
or data. 


checkpoint: (1)* A place in a routine where a check, or a 
recording of data for restart purposes, is performed. (2) A 
point at which information about the status of a job and 
the system can be recorded so that the job step can be 
later restarted. (3) To record such information. 


checkpoint/restart facility: A facility for restarting execu- 
tion of a program at some point, other than at the begin- 
ning, after the program was terminated due to a program 
or system failure. A restart begins at a checkpoint of a 
job step, and uses checkpoint records to reinitialize the 
system, 


cold start: Same as /nitial program load. 


combined file: A file of cards upon which both input and 
output operations are performed. All cards in the file are 
read, but not all cards in the file are punched, interpreted 
and/or stacker selected. 


configuration: The group of machines, devices, and pro- 
grams that make up a data processing system. 


Glossary 


console: That part of a computer used for communica- 
tion between the operator and the computer. 


contention: (1) A condition on a communication channel 
when two or more locations try to transmit at the same 
time. (2) Unregulated bidding for a resource by multiple 
users. 


CRT: Cathode-ray tube. A display device on which 
images are produced on a cathode ray tube. 


data: * A representation of facts, concepts, or instructions 
in a formalized manner suitable for communication, inter- 
pretation, or processing by humans or automatic means. 


data file: A collection of related data records organized 

in aspecific manner. For example a payroll file (one 
record for each employee, showing the rate of pay, deduc- 
tions, etc) or an inventory file (one record for each inven- 
tory item, showing the cost, selling price, number of stock, 
etc). 


execute: To carry out an instruction or group of instruc- 
tions, as ina program. 


initial program load: The initialization procedure that 
Causes an operating system to commence operation. 
Abbreviated IPL. 


input: * Pertaining to a device, process, or channel involved 
in the insertion of data or states, or to the data or states 
involved. 


input/output: (1)* Pertaining to either input or output, or 
both. (2) A general term for the equipment used to com- 
municate with a computer, commonly called 1/O. (3) The 
data involved in such communication. (4) The media carry- 
ing the data for input/output. 


input queue: A queue (waiting list) of job definitions in 
direct access storage arranged in order of assigned priority. 


instaltation: A particular computing system, in terms of 
the work it does and the people who manage it, operate it, 
apply it to problems, service it, and use the results it pro- 
duces. 
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job: (1)* A specified group of tasks prescribed as a unit of 
work for a computer. By extension, a job usually includes 
all necessary computer programs, linkages, files, and instruc- 
tions to the operating system. (2) A collection of related 
problem programs, identified in the job stream by a JOB 
statement. 


job step: A unit of work associated with one processing 
program or one cataloged procedure and related data. A 
job consists of one or more job steps. 


job stream: The sequence of operation control statements 
and data submitted to an operating system on an input unit 
especially activated for this purpose by the operator. 


main storage: The general purpose storage of a computer. 


MFCM: Multi-Function Card Machine. Same as 1BM 2560 
Multi-Function Card Machine. 


MFCU: Multi-Function Card Unit. Same as 1BM 5424 
Multi-Function Card Unit. 


operating system: * Software which controls the execution 
of computer programs and which may provide scheduling, 
debugging, input/output control, accounting, compilation, 
storage assignment, data management, and related services. 


operation control language: A programming language used 
to code operation control statements. Abbreviated OCL. 


operation control statement: A statement in a job or job 
step that is used in identifying the job or describing its 
requirements to the operating system. 


operator control command: : A statement to the supervisor 
issued via the console device, that causes the supervisor to 
Provide requested information, alter normal operations, 
initiate new operations, or terminate existing Operations. 
Abbreviated OCC. 


output: * Pertaining to a device, process, or channel involved 
in an output process, or to the data or states involved. 


output queue: A queue of control information describing 
system output that specifies to an output writer the location 
and disposition of system output. 


Partition: A subdivision of main storage. 


priority: A rank assigned to a job that determines its pre- 
cedence in receiving system resources. 


queue: (1) A waiting line or list formed by items ina sys- 
tem waiting for service; for example, jobs to be performed. 
(2) To arrange in, or form, a queue. 


restart: The process of resuming a job at a checkpoint 
within the job step that caused abnormal termination. See 
checkpoint/restart facility. 


rollout/rollin: An optional feature of the operating system 
that allows the temporary reassignment of a main storage 
Partition from one program to another. 


spooling: The reading and writing of input and output 
streams on disk concurrently with job execution, in a for- 
mat convenient for later processing or output operations. 


step: (1) * One operation in a computer routine. (2) See 
job step. 


storage: * (1) Pertaining to a device into which data can be 
entered, in which it can be held, and from which it can be 
retrieved at a later time. (2) Loosely, any device that can 
store data. (3) Synonymous with memory. 


system generation: The process of tailoring the system con- 
tro! programming to suit a user’s requirements and includ- 
ing the desired program products. 


system input device: A device specified as a source of input. 
system history area: A space on a direct access storage de- 
vice in which information relating to system activity is 


stored. 


system output device: A device assigned to record output 
data. 


throughput: The total volume of work performed by a 
computing system over a given period of time. 


unit-record devices: Card readers, card punches, and 
printers. 


/. (OCL) 

as job stream delimiter 2-5 

description 6-9 
$SPOOL (see spool file) 
*PCHQ (*PQ) operand, CANCEL command 5-2 
*PRTQ (*WQ) operand, CANCEL command 5-2 
*RDROQ (*RQ) operand, CANCEL command 5-2 


ALIGN FORM TO LINE 1 MESSAGE 2-14, 2-17 
ALIGN parameter, PRINTER OCL_ 6-5 
alignment of forms 2-17 
ASSIGN (OCL) 6-1 
asynchronous operation 1-2 
autostart option 

at system generation 2-3 

for print spooling 2-14 

for punch spooling 2-22 

for second printer 9-1 
autowrite option 

at system generation 2-3 

for print spooling 2-14 

for punch spooling 2-19 

for second printer 9-1 


CANCEL (CN) command 
at IPL 2-4, 3-1 
description 5-2 
for input spooling 2-8 
for job execution 2-13 
for print spooling 2-19 
for punch spooling 2-23 
summary  F-2 
card type operand, CHANGE card type 
command 5-4 
card type option at system generation 2-3 
CARDNO parameter 
for punch spooling 2-23 
PUNCH OCL 6-6 
chain image for second printer 9-1 


index 


CHANGE (G) command 
description 5-4 
for input spooling 2-9 
for print spooling 2-18 
for punch spooling 2-23 
summary F-3 
CHANGE CARD TO TYPE nnn message 2-23, 6-6 
CHANGE FORM TO TYPE nnn message 2-16 
changing 
card types 2-23, 5-4 
copies 5-5 
copies, print 2-17 
copies, punch 2-23 
core 5-6 
forms types 2-16, 5-7 
partition assignment 5-8 
Partition system input device 5-21 
print chain/train 2-17 
priority 5-9 
characters** operand 
CANCEL command 5-3 
CHANGE card type command 5-4 
CHANGE copies command 5-5 
CHANGE core command 5-6 
CHANGE forms type command 5-7 
CHANGE partition command 5-8 
CHANGE priority command 5-9 
HOLD command _ 5-18 
KEEP command 5-19 
RELEASE command 5-22 
checkpoint/restart 4-1 
CLOSE parameter, PRINTER OCL 6-5 
CN (see CANCEL) 
code parameter, READER OCL 6-8 
configuration, minimum 1-1 
CONSOLE as system input device 5-21 
contention, device 2-12 
COPIES parameter 
for print spooling 2-17 
for punch spooling 2-23 
PRINTER OCL 6-4 
PUNCH OCL 6-6 
copies, changing number of 5-4 
CORE operand, CHANGE core command _ 5-6 
CORE parameter, JOB OCL_ 6-3 
CPY operand, CHANGE copies command 5-5 
CRD operand, CHANGE card type command 5-4 


Index X-1 


D (see DISPLAY) 
DATE (DT) command summary F-3 
DEFER parameter 
PRINTER OCL 2-15, 6-4 
PUNCH OCL 2-22, 6-6 
device contention 
description 2-12 
reducing 1-3 
device operand, READER command 5-21 
DEVICE parameter 
PRINTER OCL 6-4 
PUNCH OCL_ 6-6 
devices supported 1-2 
disk types, spool file 1- 
DISPLAY (D) command 
description 5-11 
for print spooling 2-20 
for punch spooling 2-25 
reader queue for input spooling 2-9 
summary F-3 
display formats 5-15 
displaying 
partition status 5-11 
print queue 5-16 
punch queue 5-16 
reader queue 5-15 
system history 5-14 
system status 5-11 
task history 5-11 
DT (see DATE) 
DUMP (K) command 
for job execution 2-13 
multiple copies 2-17 
summary F-4 


1 


E (see TRACE) 

END OF PCH STEP message 2-21, 2-23, 6-6 
error conditions when input spooling 2-8 
error conditions when print spooling 2-18 
error conditions when punch spooling 2-23 
errors 


disk 8-1 
printer 2-18 
Punch 2-23 


executing jobs 2-10 

execution-time diagnostic 2-13 

extended restart option at system 
generation 2-3 


format, queue A-1 
forms alignment 2-17, 6-5 
forms type for starting print writer 2-16 


X-2 


forms type operand 
CHANGE forms type command 5-7 
START command 5-26 
with second printer 9-1 
forms type option at system 
generation 2-3 
FORMSNO parameter 
for print spooling 2-16 
PRINTER OCL 6-4 
FRM operand, CHANGE forms type 
command 5-7 


G (see CHANGE) 

generating spooling system 2-1 
glossary G-1 

grouping job steps 2-16 


H (see HOLD or HISTORY) 
HALT (HT) command summary F-3 
high-priority operand, HIPTY command 5-17 
HIPTY (HP) command 

description 5-17 

summary F-4 
HISTORY (H) operand, DISPLAY command 5-14 
history, displaying system/task 5-11 
HOLD (H) command 

description 5-18 

for input spooling 2-8 

for print spooling 2-19 

for punch spooling 2-24 

summary F-4 
holding jobs on queue 5-18 
HT (see HALT) 


| (see IDELETE) 
IDELETE (I) command summary F-5 
identification of jobs on the queue 2-10 
IMAGE statement for changing print 
chain/train 2-18 
image, print chain 9-1 
initial program load (see IPL) 
input device, changing 5-21 
input spooling 
description 2-5 
devices 2-1 
limitations 2-6 
IPL 2-4 


JOB (OCL) 
description 6-2 
for input spooling 2-5 

job description 2-5 

job execution 2-10 

job initiation in partitions 2-11 

job mode 6-9 

job priority, changing 5-9 

job step description 2-5 

job steps, grouping 2-16 

job stream description 2-5 

job(s} on queue 
canceling 5-2 
changing requirements for 5-4 
holding 5-18 
keeping 5-19 
releasing 5-22 

jobname operand 
CANCEL command 5-3 
CHANGE card type command 5-4 
CHANGE copies command 5-5 
CHANGE core command 5-6 
CHANGE forms type command 5-7 
CHANGE partition command 5-8 
CHANGE priority command 5-9 
HOLD command 5-18 
KEEP command 5-19 
RELEASE command 5-22 
REUSE command 5-24 

jobname parameter, JOB OCL 6-2 


K (see DUMP) 

KEEP command 
description 5-19 
for input spooling 2-9 
for print spooling 2-20 
for punch spooling 2-25 
summary F-5 

KP (see KEEP) 


last pages, printing 2-21 

levels of device support 1-2 

levels of support storage 
requirements B-1 

levels of support, generating 2-1 

LINES parameter, PRINTER OCL 6-4 


main data area disk space 2-2 

main storage requirements B-1 

main storage requirements at system 

generation 2-4 

main storage size, changing 5-6 

messages 
ALIGN FORM TO LINE 1. 2-14, 2-17 
CHANGE CARD TO TYPE nnn 2-23, 6-6 
CHANGE FORM TO TYPE nnn 2-16 
END OF PCH STEP 2-21, 2-21, 6-6 
MFCM NOT AVAILABLE 2-12 
nnn IS ACTIVE FORMS TYPE 2-20 
PCH RESTART PENDING 2-22, 5-23 
PCH WRITER TERMINATED 2-12, 2-25 
PCHQ 1S EMPTY/HELD 2-4, 2-22 
PRn-xxx ACTIVE FORMS TYPE 9-1 
PRT RESTART PENDING 2-16, 2-21, 5-23 
PRT WRITER TERMINATED 2-19 
PRT WRITER TERMINATED PAGE nnn 2-21 
PRTQ IS EMPTY/HELD 2-4, 2-14 
PRTQ IS EMPTY/HELD TYPE nnn 2-16 
READER/WRITER ACTIVE 2-4 
SPOOL FILE CONTAINS DATA 5-25 
SPOOL FILE IS FULL 8-1 
SPOOL RDR TERMINATED 2-8, 2-25 
1403 NOT AVAILABLE 2-19 

messages, spooling (SP) E-1 

MFCM as s¥stem input device 5-21 

MFCM NOT AVAILABLE message 2-12 

MFCU as system input device 5-21 

mode of operation 2-2 

multiple copies 
(see also COPIES) 
of printed output 2-17 
of punched output 2-23 

multiple jobs, manipulating (see 

characters** operand) 


N operand, DISPLAY status command 5-11 
NEW parameter, START command 5-25 
NHT (see NOHALT) 
NI (see NOIDELETE) 
NO INPUT JOB AVAILABLE message 2-3 
NOHALT (NHT) command summary F-5 
NOIDELETE (Ni) command summary F-5 
number operand 
CHANGE copies command 5-5 
RESTART command _ 5-23 


Index X-3 


OCC (see operator control commands) 
OCL (operation control language) 
considerations 6-1 
considerations for input spooling 2-5 
operation, asynchronous’ 1-2 
Operator control commands (OCC) 
descriptions 5-1 
for second printer 9-1 
summary F-1 
syntax F-1 
output copies, changing number of 5-4 
Output spooling 
print 2-14 
punch 2-21 
output spooling devices, selecting 2-1 
output, restarting print/punch 
output 5-23 


P (see PCH or STOP) 
PAGE (PG) operand 
RESTART command 5-23 
STOP command 5-27 
page count, displaying current 2-21 
pages, skipping back 2-21 
partition assignment, changing 5-8 
PARTITION parameter, JOB OCL 6-3 
partition status display 5-13 
partition status, displaying 5-11 
partition system input device, 
changing 5-21 
partitions with spool support 2-2 
PCH (P) operand 
RESTART command 5-23 
START command 5-26 
STOP command 5-27 
PCH RESTART PENDING message 2-21, 5-23 
PCH WRITER TERMINATED message 2-25 
PCHOQ (PQ) operand 
CANCEL command 5-2 
CHANGE card type command 5-4 
CHANGE copies command 5-5 
CHANGE priority command 5-9 
DISPLAY command 5-15 
HOLD command 5-18 
KEEP command 5-19 
RELEASE command 5-22 
REUSE command 5-24 
PCHQ IS EMPTY/HELD message 2-4, 2-22 
performance 
factors 7-1 
improving 1-3 
job stream 2-6 
using DEFER option (print) 2-15 
using DEFER option (punch) 2-22 
variations 1-2 
PQ (see PCHQ) 
preventing job execution 5-18 


X-4 


preventing job printing/punching 5-18 
print chain/train, changing 2-18 
print devices, starting 2-15 
print output, restarting 5-23 
print queue 

building 2-12 

canceling 5-2 

displaying 5-11 

releasing 5-22 

reusing space 5-24 
print queue display for second 

printer 9-2 

print queue display format 2-20, 5-16 
print spooling 2-14 
print spooling devices, selecting 2-1 


print writer 
description 2-14 
starting 5-25 


starting/restarting 2-16 
stopping 5-27 
PRINTER (OCL) 6-4 
printer, second 1403 9-1 
printing types, specifying at system 
generation 2-2 
PRIORITY parameter 
JOB OCL 6-2 
PRINTER OCL 6-5 
PUNCH OCL 6-7 
priority, changing job 5-9 
Priority, print queue 2-14 
processing without spool 3-1 
program execution 
starting 5-25 
stopping 5-27 
program, canceling 5-2 
PRT (W) operand 
RESTART command 5-23 
START command 5-26 
STOP command 5-27 
PRT RESTART PENDING 
message 2-16, 2-21, 5-23 
PRT WRITER TERMINATED message 2-19 
PRT WRITER TERMINATED PAGE nnn 
message 2-21 
PRTQ (WQ) operand 
CANCEL command 5-2 
CHANGE copies command 5-5 
CHANGE forms type command 5-7 
CHANGE priority command 5-9 
DISPLAY command 5-15 
HOLD command 5-18 
KEEP command 5-19 
RELEASE command 5-22 
REUSE command 5-24 
PRTQ IS EMPTY/HELD message 2-4, 2-14 
PRTQ IS EMPTY/HELD TYPE nnn message 2-16 
PR1 (W1) operand for second printer 9-1 
PR1-xxx ACTIVE FORMS TYPE message 9-2 
PR2 (W2) operand for second printer 9-1 
PR2-xxx ACTIVE FORMS TYPE message 9-1 


PTN.x operand, CHANGE partition 
command 5-8 
PTY (Y) command 
description 5-20 
summary F-5 
PTY (Y) operand, CHANGE priority 
command 5-9 
PUNCH (OCL) 6-6 
punch devices, starting 2-15 
punch output, restarting 5-23 
punch queue 
building 2-12 
canceling 5-2 
displaying 5-11 
releasing 5-22 
reusing space 5-24 
punch queue display format 2-25, 5-16 
punch spooling 2-21 
punch spooling devices, selecting 2-1 
punch writer 
description 2-21 
Starting 5-25 
stopping 5-27 
punching types, specifying at system 
generation 2-2 
P1 operand 
CANCEL command 5-3 
DISPLAY status command 5-11 
PTY command 5-20 
READER command = 5-21 
START command 5-25, 5-26 
STOP command 5-27 
P2 operand 
CANCEL command 5-3 
DISPLAY status command 5-11 
PTY command 5-20 
READER command 5-21 
START command 5-25, 5-26 
STOP command 5-27 
P3 operand 
CANCEL command 5-3 
DISPLAY status command 5-11 
PTY command 5-20 
READER command 5-21 
START command 5-25, 5-26 
STOP command = 5-27 


QCOPY parameter 
JOB OCL 6-3 
PRINTER OCL 6-5 
PUNCH OCL 6-7 
queue (see reader queue, print queue, punch 
queue} 
queue format A-1 


R (see RDR or RELEASE) 
RDR (R) operand 
(see also READER command) 
START command 5-26 
STOP command 5-27 
RDRO (RQ) operand 
CANCEL command 5-2 
CHANGE core command 5-6 
CHANGE partition command 5-8 
CHANGE priority command 5-9 
DISPLAY command 5-15 
HOLD command 5-18 
KEEP command 5-19 
RELEASE command 5-22 
RDRQ IS EMPTY/HELD message 2-3 
read card image restriction 2-13 
reader 
description 2-6 
starting 5-25 
stopping 5-27 
READER (OCL) 6-8 
READER (RDR) command 
description 5-21 
summary F-5 
reader queue 
building 2-7 
canceling 5-2 
description 2-6 
display 2-9 
display format 5-15 
displaying 5-11 
identification of jobs 2-10 
releasing 5-22 
READER/WRITER ACTIVE message 2-4 
RELEASE (R) command 
description 5-22 
for input spooling 2-9 
for print spooling 2-19 
for punch spooling 2-24 
summary F-5 
RESTART (T) command 
description 5-23 
for printing 2-16 
for punching 2-22 
for second printer 9-1 
summary F-6 
with REUSE 5-24 
restart/checkpoint 4-1 
restarting print/punch output 5-23 
REUSE (RU) command 
description 5-24 
for print spooling 2-19 
for punch spooling 2-25 
summary F-6 
with RESTART 5-24 
reusing spool file space 5-24 
RO (see ROLLOUT) 
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ROLL parameter, START command 5-26 
ROLLOUT (RO) command summary F-6 
rollout/rollin 4-2 

RQ (see RDRQ) 

RU (see REUSE) 


S (see START) 
second 1403 printer 9-1 
security, spool file 2-16, 2-22 
separator pages 2-16 
SET command summary F-6 
SIMULATE (SM) command summary F-6 
size operand, CHANGE core command 5-6 
size parameter, START command 5-25 
skipping back pages 2-21 
SM (see SIMULATE) 
SP (see SPOOL) 
SPOOL (SP) operand 
CANCEL command 5-2 
PTY command 5-20 
START command 5-25 
STOP command 5-27 
spool disk space, specifying 2-2 
spool disk unit, specifying 2-2 
spool file (SSPOOL) 
disk space 2-2 
disk types 1-1 
queues A-1 
security, print 2-16 
security, punch 2-22 
size C-1 
space, reusing 5-24 
SPOOL FILE CONTAINS DATA message 5-25 
SPOOL FILE IS FULL message 8-1 
spool messages E-1 
SPOOL parameter, JOB OCL_ 6-3 
SPOOL RDR TERMINATED message 2-8, 2-25 
spool-supported devices 1-2 


spooling 
canceling 5-2 
starting 5-25 


spooling process diagrams 1-4 
SPxxx messages E-1 
START (S) command 

at IPL 2-4 

description 5-25 

for print writer 2-16 

for second printer 9-1 

summary F-6 
starting spooling/program execution 5-25 
STATUS operand, DISPLAY command 5-11 
status, displaying system/partition 5-11 
STEP (ES) parameter, STOP command 5-27 
step mode 6-9 
step(s) (see job(s) on queue) 


X-6 


stepname operand 
CANCEL command 5-3 
CHANGE card type command 5-4 
CHANGE copies command 5-5 
CHANGE forms type command 5-7 
CHANGE priority command 5-9 
HOLD command 5-18 
KEEP command _ 5-19 
RELEASE command 5-22 
REUSE command 5-24 
STOP (P) command 
description 5-27 
for print spooling 2-19 
for punch spooling 2-24 
for second printer 9-1 
summary F-7 
storage requirements 
for second printer 9-2 
main storage B-1 
spool area C-1 
storage size, changing 5-6 
support options, storage for B-1 
support, device 1-2 
system generation 2-1 
system history display format 5-14 
system history, displaying 5-11 
system input device 
(see also READER) 
assigning at system generation 2-3 
changing for partition 5-21 
system punch device 
(see also PUNCH) 
assigning 6-6 
system status display 
5704-SC1 5-12 
5704-SC2 5-13 
system status, displaying 5-11 


T (see RESTART) 

task history display format 5-14 

task history, displaying 5-11 

task operand, DISPLAY command 5-14 

teleprocessing, spooling with 1-1 

terminating spooling/ program 
execution 5-27 

TIME (TM) command summary F-7 

time recording for print writer 2-14 

time recording option at system 
generation 2-3 

TL (see TLOG) 

TLOG (TL) command summary F-7 

TM (see TIME) 

TRACE (E) command summary F-7 


track group size parameter, START 
command 5-25 
track groups 
size D-1 
size at system generation 2-2 


unit parameter, START command 5-25 
unprintable characters 2-18 
user control of spooling 1-3 


W (see PRT) 

WO (see PRTQ) 

writer (see print writer, punch writer) 
W1 (see PR1) 

W2 (see PR2) 


Y {see PTY) 


1403 NOT AVAILABLE message 2-19 
1403 printer, second 9-2 

1442 as system input device 5-21 

2560 (see MFCM) 

3277 (see CONSOLE) 

3340/3344 main data area disk space 2-2 
3741 as spooled input device 1-1 

3741 as system input device 5-21 

5424 (see MFCU) 

5445 disk space 2-2 
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